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Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/TP40009249- 
SW6">Document Roles</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009249-SW9"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/TP40009249- 
SW9">Document Icons</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009249-SW7"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/TP40009249- 


SW7">Recommended Keys</a></span></li></ul></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009249-101909-BCIIDGJG"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/TP40009249-101909- 
BCIIDGJG">CFBundleExecutable</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009249-102003-TPXREF132"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/TP40009249-102003- 
TPXREF132">CFBundleHelpBookFolder</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009249-102021-TPXREF133"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/TP40009249-102021- 
TPXREF133">CFBundleHelpBookName</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009249-102043-TPXREF110"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/TP40009249-102043- 
TPXREF110">CFBundlelconFile</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009249-SW10"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/TP40009249- 
SW10">CFBundlelconFiles</a></span></li><li class="children " 
data-aref="//apple ref/doc/uid/TP40009249-SW13" role="treeitem"><span 
class="disclosure"></span> «span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/TP40009249- 
SW13">CFBundlelcons</a></span><ul><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009249-SW18"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/TP40009249- 
SW18">Contents of the CFBundlePrimarylcon Dictionary 
Entry</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009249-SW14"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/TP40009249- 
SW14">Contents of the CFBundleAlternatelcons Dictionary 
Entry</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009249-SW15"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/TP40009249- 
SW15">Contents of the UlNewsstandlcon 
Dictionary</a></span></li></ul></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009249-102070-TPXREF105"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/TP40009249-102070- 
TPXREF105">CFBundleldentifier</a></span></li><li class=" " 


data-aref="//apple_ref/doc/uid/TP40009249-102088-BCIFFCAF"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/TP40009249-102088- 
BCIFFCAF">CFBundlelnfoDictionaryVersion</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009249-109552-TPXREF111"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/TP40009249-109552- 
TPXREF111">CFBundleLocalizations</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009249-109585"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/TP40009249- 
109585">CFBundleName</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009249-111321-TPXREF112"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/TP40009249-111321- 
TPXREF112">CFBundlePackageType</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009249-111349-TPXREF113"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/TP40009249-111349- 
TPXREF113">CFBundleShortVersionString</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009249-SW3"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/TP40009249- 
SW3">CFBundleSpokenName</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009249-102207-TPXREF115"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/TP40009249-102207- 
TPXREF115">CFBundleURLTypes</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009249-102364-TPXREF106"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/TP40009249-102364- 
TPXREF106">CFBundleVersion</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009249-122557-BAJBIHIE"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/TP40009249-122557- 
BAJBIHIE">CFPlugInDynamicRegistration</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009249-122575"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/TP40009249- 
122575">CFPlugInDynamicRegisterFunction</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009249-122593-BAJHDDJF"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/TP40009249-122593- 


BAJHDDJF">CFPluginFactories</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009249-122611-BAJCGCBI"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/TP40009249-122611- 
BAJCGCBI">CFPlugInTypes</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009249-122633"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/TP40009249- 
122633">CFPIuginUnloadFunction</a></span></li></ul></li><li 
class="children " data-aref="//apple_ref/doc/uid/TP40009250-SW1" 
role="treeitem"><span class="disclosure"></span><span 
class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/LaunchServicesKeys.html#//apple_ref/doc/uid/TP40009250- 
SW1">Launch Services Keys</a></span><ul><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009250-SW3"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/LaunchServicesKeys.html#//apple_ref/doc/uid/TP40009250-SW3">Key 
Summary </a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009250-SW8"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/LaunchServicesKeys.html#//apple_ref/doc/uid/TP40009250- 
SW8">LSApplicationCategoryType</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009250-SW14"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/LaunchServicesKeys.html#//apple_ref/doc/uid/TP40009250- 
SW14">LSApplicationQueriesSchemes</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009250-106825-TPXREF124"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/LaunchServicesKeys.html#//apple_ref/doc/uid/TP40009250-106825- 
TPXREF124">LSArchitecturePriority</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009250-109268-BCIGFHGH"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/LaunchServicesKeys.html#//apple_ref/doc/uid/TP40009250-109268- 
BCIGFHGH">LSBackgroundOnly</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009250-SW9"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/LaunchServicesKeys.html#//apple_ref/doc/uid/TP40009250- 
SW9">LSEnvironment</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009250-SW10"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/LaunchServicesKeys.html#//apple_ref/doc/uid/TP40009250- 
SW10">LSFileQuarantineEnabled</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009250-SW6"><span 
class="nodisclosure"></span><span class="sectionName"><a 


href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/LaunchServicesKeys.html#//apple_ref/doc/uid/TP40009250- 
SW6">LSFileQuarantineExcludedPathPatterns</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009250-106873-BAJCDJAD"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/LaunchServicesKeys.html#//apple_ref/doc/uid/TP40009250-106873- 
BAJCDJAD">LSGetAppDiedEvents</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009250-SW5"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/LaunchServicesKeys.html#//apple_ref/doc/uid/TP40009250- 
SW5">LSMinimumSystemVersion</a></span></li><li class=" " 
data-aref="//apple ref/doc/uid/TP40009250-113253-BAJDHACB"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/LaunchServicesKeys.html#//apple_ref/doc/uid/TP40009250-113253- 
BAJDHACB">LSMinimumSystemVersionByArchitecture</a></span></li><li 
class=" " data-aref="//apple_ref/doc/uid/TP40009250-113300-BAJGJADD"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/LaunchServicesKeys.html#//apple_ref/doc/uid/TP40009250-113300- 
BAJGJADD">LSMultiplelnstancesProhibited</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009250-SW2"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/LaunchServicesKeys.html#//apple_ref/doc/uid/TP40009250- 
SW2">LSRequiresIPhoneOS</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009250-108166-TPXREF128"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/LaunchServicesKeys.html#//apple_ref/doc/uid/TP40009250-108166- 
TPXREF128">LSRequiresNativeExecution</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009250-SW13"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/LaunchServicesKeys.html#//apple_ref/doc/uid/TP40009250- 
SW13">LSSupportsOpeningDocumentsInPlace</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009250-108256-TPXREF136"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/LaunchServicesKeys.html#//apple_ref/doc/uid/TP40009250-108256- 
TPXREF136">LSUIElement</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009250-113616-TPXREF134"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/LaunchServicesKeys.html#//apple_ref/doc/uid/TP40009250-113616- 
TPXREF134">LSUIPresentationMode</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009250-113831-BAJCCECB"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/LaunchServicesKeys.html#//apple_ref/doc/uid/TP40009250-113831- 
BAJCCECB">LSVisiblelnClassic</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009250-SW18"><span 


class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/LaunchServicesKeys.html#//apple_ref/doc/uid/TP40009250- 
SW18">MinimumOSVersion</a></span></li></ul></li><li class="children " 
data-aref="//apple_ref/doc/uid/TP40009251-SW1" role="treeitem"><span 
class="disclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251-SW1">Cocoa 
Keys</a></span><ul><li class=" " data-aref="//apple ref/doc/uid/TP40009251- 
SW3"><span class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251-SW3">Key 

Summary </a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009251-SW67"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW67">GCSupportedGameControllers</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009251-SW66"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW66">GCSupportsMultipleMicroGamepads</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009251-SW22"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW22">GKGameCenterBadgingDisabled</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009251-SW23"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW23">GKShowChallengeBanners</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009251-SW46"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW46">NETestAppMapping</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009251-SW74"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW74">NFCReaderUsageDescription</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009251-SW47"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW47">NSAppleMusicUsageDescription</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009251-SW5"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW5">NSAppleScriptEnabled</a></span></li><li class="children " data- 
aref="//apple_ref/doc/uid/TP40009251-SW33" role="treeitem"><span 


class="disclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW33">NSAppTransportSecurity</a></span><ul><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009251-SW35"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251-SW35">ATS 
Configuration Basics</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009251-SW55"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251-SW55">Using ATS in 
Apple Frameworks</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009251-SW54"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251-SW54">Availability of 
ATS for Remote and Local Connections</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009251-SW57"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251-SW57">Requirements 
for Connecting Using ATS</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009251-SW58"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251-SW58">Certificate 
Transparency</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009251-SW61"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251-SW61">ATS and 
HTTPS Server Trust Evaluation Requirements</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009251-SW68"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251-SW68">Supporting 
Older Operating Systems</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009251-SW59"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251-SW59">App Store 
Review for ATS</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009251-SW60"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251-SW60">ATS Dictionary 
Details</a></span></li><li class="children " 
data-aref="//apple_ref/doc/uid/TP40009251-SW36" role="treeitem"><span 
class="disclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251-SW36">ATS 
Examples</a></span><ul><li class=" " 


data-aref="//apple_ref/doc/uid/TP40009251-SW37"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251-SW37">Allowing 
Insecure Connection to a Single Server</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009251-SW38"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251-SW38">Allowing 
Lowered Security to a Single Server</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009251-SW39"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251-SW39">Using ATS For 
Your Servers and Allowing Insecure Connections 
Elsewhere</a></span></li></ul></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009251-SW40"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251-SW40">Debugging 
ATS Connections</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009251-SW41"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251-SW41">Using the 
nscurl Tool to Diagnose ATS Connection Issues</a></span></li></ul></li><li 
class=" " data-aref="//apple ref/doc/uid/TP40009251-SW20"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW20">NSBluetoothPeripheralUsageDescription</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009251-SW15"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW15">NSCalendarsUsageDescription</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009251-SW24"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW24">NSCameraUsageDescription</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009251-SW14"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW14">NSContactsUsageDescription</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009251-113843"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
113843">NSDockTilePlugIn</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009251-SW75"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 


Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW75">NSFacelDUsageDescription</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009251-SW76"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW76">NSHealthClinicalHealthRecordsShareUsageDescription</a></span></ 
li><li class=" " data-aref="//apple_ref/doc/uid/TP40009251-SW77"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW77">NSHealthRequiredReadAuthorizationTypeldentifier</a></span></li><li 
class=" " data-aref="//apple_ref/doc/uid/TP40009251-SW78"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW78">NSHealthRequiredWriteAuthorizationTypeldentifiers</a></span></ 
li><li class=" " data-aref="//apple_ref/doc/uid/TP40009251-SW48"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW48">NSHealthShareUsageDescription</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009251-SW49"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW49">NSHealthUpdateUsageDescription</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009251-SW50"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW50">NSHomekKitUsageDescription</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009251-112854-TPXREF117"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251-112854- 
TPXREF117">NSHumanReadableCopyright</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009251-107164-TPXREF118"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251-107164- 
TPXREF118">NSJavaNeeded</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009251-111891-TPXREF119"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251-111891- 
TPXREF119">NSJavaPath</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009251-111903-TPXREF120"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251-111903- 
TPXREF120">NSJavaRoot</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009251-SW18"><span 
class="nodisclosure"></span><span class="sectionName"><a 


href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW18">NSLocationAlwaysUsageDescription</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009251-SW27"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW27">NSLocationUsageDescription</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009251-SW26"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW26">NSLocationWhenInUseUsageDescription</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009251-107221-TPXREF121"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251-107221- 
TPXREF121">NSMainNibFile</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009251-SW25"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW25">NSMicrophoneUsageDescription</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009251-SW21"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW21">NSMotionUsageDescription</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009251-SW2"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW2">NSPersistentStoreTypeKey</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009251-SW73"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW73">NSPhotoLibraryAddUsageDescription</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009251-SW17"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW17">NSPhotoLibraryUsageDescription</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009251-114152-TPXREF122"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251-114152- 
TPXREF122">NSPrefPanelconFile</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009251-114174-BAJIHEFE"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251-114174- 
BAJIHEFE">NSPrefPanelconLabel</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009251-SW11"><span 


class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW11">NSPrincipalClass</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009251-SW16"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW16">NSRemindersUsageDescription</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009251-107265-TPXREF123"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251-107265- 
TPXREF123">NSServices</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009251-SW51"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW51">NSSiriUsageDescription</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009251-SW52"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW52">NSSpeechRecognitionUsageDescription</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009251-SW13"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW13">NSSupportsAutomaticTermination</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009251-SW45"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW45">NSSupportsPurgeableLocalStorage</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009251-SW12"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW12">NSSupportsSuddenTermination</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009251-SW32"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW32">NSUbiquitousContainers</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009251-SW29"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW29">NSUbiquitousContainerlsDocumentScopePublic</a></span></li><li 
class=" " data-aref="//apple_ref/doc/uid/TP40009251-SW31"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW31">NSUbiquitousContainerName</a></span></li><li class=" " data- 


aref="//apple_ref/doc/uid/TP40009251-SW30"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW30">NSUbiquitousContainerSupportedFolderLevels</a></span></li><li 
class=" " data-aref="//apple ref/doc/uid/TP40009251-SW4"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW4">NSUbiquitousDisplaySet</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009251-SW28"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW28">NSUserActivityTypes</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009251-SW19"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW19">NSUserNotificationAlertStyle</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009251-SW53"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW53">NSVideoSubscriberAccountUsageDescription</a></span></li><li 
class=" " data-aref="//apple_ref/doc/uid/TP40009251-SW8"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW8">UTExportedTypeDeclarations</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009251-SW9"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251- 
SW9">UTImportedTypeDeclarations</a></span></li></ul></li><li 
class="children " data-aref="//apple_ref/doc/uid/TP40009253-SW1" 
role="treeitem"><span class="disclosure"></span><span 
class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/GeneralPurposeKeys.html#//apple_ref/doc/uid/TP40009253- 
SW1">macOS Keys</a></span><ul><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009253-SW2"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/GeneralPurposeKeys.html#//apple_ref/doc/uid/TP40009253-SW2">Key 
Summary </a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009253-106577-TPXREF130"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/GeneralPurposeKeys.html#//apple_ref/doc/uid/TP40009253-106577- 
TPXREF130">APInstallerURL</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009253-106606-TPXREF131"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 


Articles/GeneralPurposeKeys.html#//apple_ref/doc/uid/TP40009253-106606- 
TPXREF131">APFiles</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009253-SW8"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/GeneralPurposeKeys.html#//apple_ref/doc/uid/TP40009253- 
SW8">ATSApplicationFontsPath</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009253-122531"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/GeneralPurposeKeys.html#//apple_ref/doc/uid/TP40009253- 
122531">CSResourcesFileMapped</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009253-SW5"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/GeneralPurposeKeys.html#//apple_ref/doc/uid/TP40009253- 
SW5">NSMainStoryboardFile</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009253-SW4"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/GeneralPurposeKeys.html#//apple_ref/doc/uid/TP40009253- 
SW4">QLSandboxUnsupported</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009253-SW17"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/GeneralPurposeKeys.html#//apple_ref/doc/uid/TP40009253- 
SW17">QuartzGLEnable</a></span></li></ul></li><li class="children " data- 
aref="//apple_ref/doc/uid/TP40009252-SW1" role="treeitem"><span 
class="disclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252-SW1">i0S 
Keys</a></span><ul><li class=" " data-aref="//apple ref/doc/uid/TP40009252- 
SW2"><span class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252-SW2">Key 
Summary</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009252-SW43"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252- 
SW43">CoreSpotlightContinuation</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009252-SW26"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252- 
SW26">INAlternativeAppNames</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009252-SW33"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252- 
SW33">MkKDirectionsApplicationSupportedModes</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009252-SW18"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 


Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252- 
SW18">UlAppFonts</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009252-SW23"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252- 
SW23">UlApplicationExitsOnSuspend</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009252-SW36"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252- 
SW36">UlApplicationShortcutltems</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009252-SW32"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252- 
SW32">UlApplicationShortcutWidget</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009252-SW38"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252- 
SW38">UlAppSupportsHDR</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009252-SW22"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252- 
SW22">UIBackgroundModes</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009252-SW11"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252- 
SW11">UIDeviceFamily</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009252-SW20"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252- 
SW20">UIFileSharingEnabled</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009252-SW13"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252- 
SW13">UlInterfaceOrientation</a></span></li><li class="children " data- 
aref="//apple_ref/doc/uid/TP40009252-SW24" role="treeitem"><span 
class="disclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252- 
SW24">UlLaunchlmagerile</a></span><ul><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009252-SW30"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252-SW30">Naming 
Your Launch Image Files</a></span></li></ul></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009252-SW28"><span 
class="nodisclosure"></span><span class="sectionName"><a 


href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252- 
SW28">UlLaunchlmages</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009252-SW40"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252- 
SW40">UlLaunchStoryboardName</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009252-SW41"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252- 
SW41">UlLaunchStoryboards</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009252-SW9"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252- 
SW9">UIMainStoryboardFile</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009252-SW25"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252- 
SW25">UINewsstandApp</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009252-SW16"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252- 
SW16">U!IPrerenderedicon</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009252-SW3"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252- 
SW3">UlRequiredDeviceCapabilities</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009252-SW12"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252- 
SW12">UlRequiresPersistentWiFi</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009252-SW15"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252- 
SW15">UIStatusBarHidden</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009252-SW14"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252- 
SW14">UIStatusBarStyle</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009252-SW4"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252- 
SW4">UISupportedExternalAccessoryProtocols</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009252-SW10"><span 


class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252- 
SW10">UISupportedinterfaceOrientations</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009252-SW37"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252- 
SW37">UISupportsDocumentBrowser</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40009252-SW44"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252- 
SW44">UlUserInterfaceStyle</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009252-SW42"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252- 
SW42">UIURLToLaunchStoryboardAssociations</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009252-SW29"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252- 
SW29">UIViewControllerBasedStatusBarAppearance</a></span></li><li 
class=" " data-aref="//apple_ref/doc/uid/TP40009252-SW5"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252- 
SW5">UIViewEdgeAntialiasing</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009252-SW6"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252- 
SW6">UIViewGroupOpacity</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40009252-SW31"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252- 
SW31">UIWhitePointAdaptivityStyle</a></span></li></ul></li><li 
class="children " data-aref="//apple_ref/doc/uid/TP40016498-SW1" 
role="treeitem"><span class="disclosure"></span><span 
class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/watchOSKeys.html#//apple_ref/doc/uid/TP40016498-SW1">watchOS 
Keys</a></span><ul><li class=" " data-aref="//apple ref/doc/uid/TP40016498- 
SW2"><span class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/watchOSKeys.html#//apple_ref/doc/uid/TP40016498-SW2">Key 
Summary </a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40016498-SW4"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/watchOSKeys.html#//apple_ref/doc/uid/TP40016498- 
SW4">CLKComplicationSupportedFamilies</a></span></li><li class=" " data- 


aref="//apple_ref/doc/uid/TP40016498-SW5"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/watchOSKeys.html#//apple_ref/doc/uid/TP40016498- 
SW5">CLKComplicationPrincipalClass</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40016498-SW11"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/watchOSKeys.html#//apple_ref/doc/uid/TP40016498- 
SW11">PUICAutoLaunchAudioOptOut</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40016498-SW8"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/watchOSKeys.html#//apple_ref/doc/uid/TP40016498- 
SW8">WkKAppBundleldentifier</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40016498-SW10"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/watchOSKeys.html#//apple_ref/doc/uid/TP40016498- 
SW10">WKBackgroundModes</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40016498-SW9"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/watchOSKeys.html#//apple_ref/doc/uid/TP40016498- 
SW9">WKCompanionAppBundleldentifier</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40016498-SW6"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/watchOSKeys.html#//apple_ref/doc/uid/TP40016498- 
SW6">WKExtensionDelegateClassName</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40016498-SW7"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/watchOSKeys.html#//apple_ref/doc/uid/TP40016498- 
SW7">WKWatchKitApp</a></span></li></ul></li><li class="children " data- 
aref="//apple_ref/doc/uid/TP40014212-SW1" role="treeitem"><span 
class="disclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212-SW1">App 
Extension Keys</a></span><ul><li class=" " 
data-aref="//apple_ref/doc/uid/TP40014212-SW4"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212-SW4">Key 
Summary </a></span></li><li class="children " 
data-aref="//apple_ref/doc/uid/TP40014212-SW29" role="treeitem"><span 
class="disclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 
SW29">General App Extension Keys</a></span><ul><li class=" " data- 
aref="//apple_ref/doc/uid/TP40014212-SW9"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 


SW9">NSExtension</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40014212-SW11"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 
SW11">NSExtensionAttributes</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40014212-SW14"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 
SW14">NSExtensionMainStoryboard</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40014212-SW53"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 
SW53">NSExtensionOverridesHostUlAppearance</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40014212-SW15"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 
SW15">NSExtensionPointldentifier</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40014212-SW16"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 
SW16">NSExtensionPrincipalClass</a></span></li></ul></li><li 
class="children " data-aref="//apple_ref/doc/uid/TP40014212-SW2" 
role="treeitem"><span class="disclosure"></span><span 
class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212-SW2">Action 
Extension Keys</a></span><ul><li class=" " 
data-aref="//apple_ref/doc/uid/TP40014212-SW35"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 
SW35">NSExtensionActionWantsFullScreenPresentation</a></span></li><li 
class=" " data-aref="//apple_ref/doc/uid/TP40014212-SW10"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 
SW10">NSExtensionActivationRule</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40014212-SW36"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 
SW36">NSExtensionActivationDictionaryVersion</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40014212-SW37"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 
SW37">NSExtensionActivationUsesStrictMatching</a></span></li><li class=" 
" data-aref="//apple ref/doc/uid/TP40014212-SW27"><span 
class="nodisclosure"></span><span class="sectionName"><a 


href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 
SW27">NSExtensionJavaScriptPreprocessingFile</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40014212-SW17"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 
SW17">NSExtensionServiceAllowsToolbarltem</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40014212-SW18"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 
SW18">NSExtensionServiceRoleType</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40014212-SW19"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 
SW19">NSExtensionServiceToolbarlconFile</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40014212-SW20"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 
SW20">NSExtensionServiceToolbarPaletteLabel</a></span></li></ul></li><li 
class="children " data-aref="//apple_ref/doc/uid/TP40014212-SW30" 
role="treeitem"><span class="disclosure"></span><span 
class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 
SW30">Custom Keyboard Extension Keys</a></span><ul><li class=" " data- 
aref="//apple_ref/doc/uid/TP40014212-SW8"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 
SW8">ISASCIICapable</a></span></li><li class=" " 

data-aref="//apple ref/doc/uid/TP40014212-SW22"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 
SW22">PrefersRightToLeft</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40014212-SW23"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 
SW23">PrimaryLanguage</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40014212-SW24"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 
SW24">RequestsOpenAccess</a></span></li></ul></li><li class="children " 
data-aref="//apple_ref/doc/uid/TP40014212-SW31" role="treeitem"><span 
class="disclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 
SW31">Document Picker and File Provider Extension Keys</a></span><ul><li 


class=" " data-aref="//apple_ref/doc/uid/TP40014212-SW12"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 
SW12">NSExtensionFileProviderDocumentGroup</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40014212-SW59"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 
SW59">NSExtensionFileProviderActions</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40014212-SW61"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 
SW61">NSExtensionFileProviderSupportsEnumeration</a></span></li><li 
class=" " data-aref="//apple_ref/doc/uid/TP40014212-SW25"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 
SW25">UIDocumentPickerModes</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40014212-SW26"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 
SW26">UIDocumentPickerSupportedFileTypes</a></span></li></ul></li><li 
class="children " data-aref="//apple_ref/doc/uid/TP40014212- 
DontLinkElementID 1" role="treeitem"><span 
class="disclosure"></span> «span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 
DontLinkElementID 1">iMessage App and Sticker Pack 
Keys</a></span><ul><li class=" " data-aref="//apple ref/doc/uid/TP40014212- 
DontLinkElementID 2"><span class="nodisclosure"» «/span» «span 
class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 
DontLinkElementID_2">MSMessagesAppPresentationContextMessages</a></ 
span></li></ul></li><li class="children " 
data-aref="//apple_ref/doc/uid/TP40014212-SW62" role="treeitem"><span 
class="disclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 
SW62">Message Filter Extension Keys</a></span><ul><li class=" " data- 
aref="//apple_ref/doc/uid/TP40014212-SW63"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 
SW63">IDMessageFilterExtensionNetworkURL</a></span></li></ul></li><li 
class="children " data-aref="//apple ref/doc/uid/TP40014212-SW54" 
role="treeitem"><span class="disclosure"></span><span 
class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 
SW54">Notification Content Extension Keys</a></span><ul><li class=" " data- 


aref="//apple_ref/doc/uid/TP40014212-SW55"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 
SW55">UNNotificationExtensionCategory</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40014212-SW56"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 
SW56">UNNotificationExtensionInitialContentSizeRatio</a></span></li><li 
class=" " data-aref="//apple_ref/doc/uid/TP40014212-SW57"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 
SW57">UNNotificationExtensionDefaultContentHidden</a></span></li><li 
class=" " data-aref="//apple_ref/doc/uid/TP40014212-SW58"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 
SW58">UNNotificationExtensionOverridesDefaultTitle</a></span></li><li 
class=" " data-aref="//apple_ref/doc/uid/TP40014212- 

DontLinkElementID 3"><span class="nodisclosure"></span><span 
class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 
DontLinkElementID_3">UNNotificationExtensionUserInteractionEnabled</a></ 
span></li></ul></li><li class="children " 
data-aref="//apple_ref/doc/uid/TP40014212-SW32" role="treeitem"><span 
class="disclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212-SW32">Photo 
Editing Extension Keys</a></span><ul><li class=" " 
data-aref="//apple_ref/doc/uid/TP40014212-SW21"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/documentation/General/Reference/InfoPlistKeyReference/ 
Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212- 
SW21">PHSupportedMediaTypes</a></span></li></ul></li><li 
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Info.plist Keys and Values"></a><hl id="pageTitle">About Info.plist Keys and 
Values</h1><a name="//apple ref/doc/uid/TP40009248- 
DontLinkElementID_6"></a><p>To provide a better experience for users, iOS 
and macOS rely on the presence of special metadata in each app or bundle. This 
metadata is used in many different ways. Some of it is displayed to the user, 
some of it is used internally by the system to identify your app and the 
document types it supports, and some of it is used by the system frameworks to 
facilitate the launch of apps. The way an app provides its metadata to the 
system is through the use of a special file called an <em>information property 
list file</em>, or <code>Info.plist</code> for short.</p><p>A property list is a 
way to structure arbitrary data that the system can access at runtime. An 
<em>information</em> property list is a specialized type of property list that 
contains configuration data for a bundle. The keys and values in the file describe 
the various behaviors and configuration options you want applied to your bundle. 
An Xcode project template typically specifies an information property list file with 
an initial set of keys and appropriate default values. You can edit the file to 
change or add keys and values, as appropriate for your project.</p><a 
name="//apple ref/doc/uid/TP40009248-DontLinkElementID 7" title="At a 
Glance"></a><h2 class="jump">At a Glance</h2><p>This document 
describes the keys and corresponding values that you can include in an 
information property list file. This document also includes an overview of 


information property list files to help you understand their importance and to 
provide tips on how to configure them.</p><section><a 
name="//apple_ref/doc/uid/TP40009248-SW2" title="The Info.plist File 
Configures Your App"></a><h3>The Info.plist File Configures Your 
App</h3><p>Every app and plug-in uses an <code>Info.plist</code> file to 
store configuration data in a place where the system can easily access it. macOS 
and iOS use <code>Info.plist</code> files to determine what icon to display for 
a bundle, what document types an app supports, and many other behaviors that 
have an impact outside the bundle itself. </p><div 
class="notebox"><aside><a name="//apple_ref/doc/uid/TP40009248-SW3" 
title="Relevant chapter"></a><p><strong>Relevant 

chapter: </strong>&nbsp; <span class="content text"><a 
href="../Articles/AboutInformationPropertyListFiles.html#//apple_ref/doc/uid/ 
TP40009254-SW1" data-renderer-version="1" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
documentation/General/Reference/InfoPlistKeyReference 3&quot;;return 

this.s oc?this.s oc(e):true">About Information Property List 
Files</a></span></p><p></p></aside></div></section><section><a 
name="//apple_ref/doc/uid/TP40009248-SW4" title="Core Foundation Keys 
Describe Common Behavior"></a><h3>Core Foundation Keys Describe 
Common Behavior</h3><p>There are many keys that you always specify, 
regardless of the type of bundle you are creating. Those keys start with a CF 
prefix and are known as the Core Foundation keys. Xcode includes the most 
important keys in your <code>Info.plist</code> automatically but there are 
others you must add manually.</p><div class="notebox"><aside><a 
name="//apple_ref/doc/uid/TP40009248-SW5" title="Relevant 
chapter"></a><p><strong>Relevant chapter: </strong>&nbsp; <span 
class="content_text"><a 
href="../Articles/CoreFoundationKeys.html#//apple_ref/doc/uid/TP40009249- 
SW1" data-renderer-version="1" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
documentation/General/Reference/InfoPlistKeyReference 4&quot;;return 
this.s_oc?this.s_oc(e):true">Core Foundation 
Keys</a></span></p><p></p></aside></div></section><section><a 
name="//apple_ref/doc/uid/TP40009248-SW6" title="Launch Services Keys 
Describe Launch-Time Behavior"></a><h3>Launch Services Keys Describe 
Launch-Time Behavior</h3><p>Launch Services provides support for launching 
apps. To do this, though, it needs to know information about how your app wants 
to be launched. The Launch Services keys describe the way your app prefers to 
be launched. </p><div class="notebox"><aside><a 
name="//apple_ref/doc/uid/TP40009248-SW7" title="Relevant 
chapter"></a><p><strong>Relevant chapter: </strong>&nbsp; <span 
class="content_text"><a 
href="../Articles/LaunchServicesKeys.html#//apple_ref/doc/uid/TP40009250- 
SW1" data-renderer-version="1" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
documentation/General/Reference/InfoPlistKeyReference 5&quot;;return 

this.s oc?this.s oc(e):true">Launch Services 
Keys</a></span></p><p></p></aside></div></section><section><a 
name="//apple ref/doc/uid/TP40009248-SW8" title="Cocoa Keys Describe 
Behavior for Cocoa and Cocoa Touch Apps"></a><h3>Cocoa Keys Describe 
Behavior for Cocoa and Cocoa Touch Apps</h3><p>The Cocoa and Cocoa 
Touch frameworks use keys to identify high-level information such as your app’s 
main nib file and principal class. The Cocoa keys describe those and other keys 


that affect how the Cocoa and Cocoa Touch frameworks initialize and run your 
app. </p><div class="notebox"><aside><a 
name="//apple_ref/doc/uid/TP40009248-SW9" title="Relevant 
chapter"></a><p><strong>Relevant chapter:</strong>&nbsp; «span 
class="content_text"><a 
href="../Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251-SW1" data- 
renderer-version="1" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
documentation/General/Reference/InfoPlistKeyReference 6&quot;;return 
this.s oc?this.s oc(e):true">Cocoa 
Keys</a></span></p><p></p></aside></div></section><section><a 
name="//apple_ref/doc/uid/TP40009248-SW10" title="macOS Keys Describe 
Behavior for macOS Apps"></a><h3>macOS Keys Describe Behavior for macOS 
Apps</h3><p>Some macOS frameworks use keys to modify their basic 
behavior. Developers of Mac apps might include these keys during testing or to 
modify certain aspects of your app’s behavior. </p><div 
class="notebox"><aside><a name="//apple_ref/doc/uid/TP40009248-SW11" 
title="Relevant chapter"></a><p><strong>Relevant 

chapter: </strong>&nbsp; <span class="content text"><a 
href="../Articles/GeneralPurposeKeys.html#//apple_ref/doc/uid/TP40009253- 
SW1" data-renderer-version="1" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
documentation/General/Reference/InfoPlistKeyReference_7&quot;;return 
this.s oc?this.s oc(e):true">macOS 
Keys</a></span></p><p></p></aside></div></section><section><a 
name="//apple_ref/doc/uid/TP40009248-SW12" title="iOS Keys Describe 
Behavior for ¡OS Apps"></a><h3>iOS Keys Describe Behavior for iOS 
Apps</h3><p>An iOS app communicates a lot of information to the system 
using <code>Info.plist</code> keys. Xcode supplies a standard 
<code>Info.plist</code> with the most important keys but most apps need to 
augment the standard file with additional keys describing everything from the 
app’s initial orientation to whether it supports file sharing. </p><div 
class="notebox"><aside><a name="//apple_ref/doc/uid/TP40009248-SW13" 
title="Relevant chapter"></a><p><strong>Relevant 

chapter: </strong>&nbsp; <span class="content text"><a 
href="../Articles/iPhoneOSKeys.html#//apple_ref/doc/uid/TP40009252-SW1" data- 
renderer-version="1" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
documentation/General/Reference/InfoPlistKeyReference 8&quot;;return 
this.s oc?this.s oc(e):true">iOS 
Keys</a></span></p><p></p></aside></div></section><section><a 
name="//apple_ref/doc/uid/TP40009248-SW16" title="watchOS Keys Describe 
Behavior for Watch Apps"></a><h3>watchOS Keys Describe Behavior for 
Watch Apps</h3><p>Use the <code>Info.plist</code> keys associated with 
the watchOS frameworks to configure your Watch apps and WatchKit 
extensions.</p><div class="notebox"><aside><a 
name="//apple_ref/doc/uid/TP40009248-SW17" title="Relevant 
chapter"></a><p><strong>Relevant chapter: </strong>&nbsp; <span 
class="content_text"><a 
href="../Articles/watchOSKeys.html#//apple_ref/doc/uid/TP40016498-SW1" data- 
renderer-version="1" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
documentation/General/Reference/InfoPlistKeyReference 9&quot;;return 
this.s oc?this.s oc(e):true">watchOS 


Keys</a></span></p><p></p></aside></div></section><section><a 
name="//apple_ref/doc/uid/TP40009248-SW14" title="App Extension Keys 
Describe Behavior for iOS and macOS App Extensions"></a><h3>App Extension 
Keys Describe Behavior for iOS and macOS App Extensions</h3><p>App 
extensions let you make custom behaviors available in other apps and in system 
facilities such as notification center. Xcode’s app extension templates each 
supply a standard <code>Info.plist</code> file with the most important keys, 
but you can specify additional keys that describe custom behavior for your app 
extensions. </p><div class="notebox"><aside><a 
name="//apple_ref/doc/uid/TP40009248-SW15" title="Relevant 
chapter"></a><p><strong>Relevant chapter: </strong>&nbsp; <span 
class="content_text"><a 
href="../Articles/AppExtensionKeys.html#//apple_ref/doc/uid/TP40014212-SW1" 
data-renderer-version="1" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
documentation/General/Reference/InfoPlistKeyReference 10&quot;;return 
this.s oc?this.s oc(e):true">App Extension 
Keys</a></span></p><p></p></aside></div></section><div 
id="introSeeAlsoSection"><a name="//apple ref/doc/uid/TP40009248- 
DontLinkElementID 8" title="See Also"></a><h2 class="jump">See 
Also</h2><p>For an introduction to property lists, including how they are 
structured and how you use them in general, see <em><a 
href="../../../../Cocoa/Conceptual/PropertyLists/Introduction/Introduction.html#// 
apple_ref/doc/uid/10000048i" data-renderer-version="1" target="_ self" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
documentation/Cocoa/Conceptual/PropertyLists/Introduc_1&quot;;return 
this.s_oc?this.s_oc(e):true">Property List Programming Guide</a></em>. 
</p><p>Some <code>Info.plist</code> keys use Uniform Type Identifiers 
(UTIs) to refer to data of different types. For an introduction to UTIs and how they 
are specified, see <em><a 
href="../../../../FileManagement/Conceptual/understanding utis/understand utis i 
ntro/understand utis intro.html£//apple ref/doc/uid/TP40001319" data-renderer- 
version="1" target=" self" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
documentation/FileManagement/Conceptual/understanding_1&quot;;return 
this.s_oc?this.s_oc(e):true">Uniform Type Identifiers Overview</a></em>. 
</p><p>Kernel extension developers need to use certain 
<code>Info.plist</code> keys in different ways than app developers do, and 
also need some kernel-extension-specific keys that have no use in app 
development. <em>If you are developing a kernel extension</em>, refer to the 
chapter <span class="content_text"><a 
href="../../../../Darwin/Conceptual/KEXTConcept/Articles/infoplist_keys.html#// 
apple_ref/doc/uid/TP40009481" data-renderer-version="1" target="_self" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
documentation/Darwin/Conceptual/KEXTConcept/Articles/ 1&quot;;return 
this.s oc?this.s oc(e):true">Info.plist Properties for Kernel 
Extensions</a></span> in <em><a 
href="../../../../Darwin/Conceptual/KEXTConcept/KEXTConceptintro/introduction.ht 
ml#//apple_ref/doc/uid/TP40001063" data-renderer-version="1" target="_self" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
documentation/Darwin/Conceptual/KEXTConcept/KEXTConce_1&quot;;return 
this.s_oc?this.s_oc(e):true">Kernel Extension Programming Topics</a></em>. 
</p></div> 
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href="../../../Resources/1282/CSS/screen.css"> 


<!-- xcode CSS --> 

<link rel="stylesheet" type="text/css" 
href="../../../Resources/1282/CSS/feedback.css"> 

<meta name="viewport" content="width=device-width, initial-scale=1, 
maximum-scale=1"> 

<meta id="platforms" name="platforms" content="OS X,Safari"> 

</head> 
<body class="" id=""><a name="//apple ref/doc/uid/DTS10003699-Intro" 
title="Voices"></a> 

<div id=" omniture top"> 

<!-- SiteCatalyst code version: H.8. Copyright 1997-2006 Omniture, Inc. --> 

<script type="text/javascript"> 

/* RSID: */ 

var s account="appleglobal,appleusdeveloper,dappdeveloperlib" 

</script> 


<script type="text/javascript" 

src="https://www.apple.com/metrics/scripts/s_code_h.js"></script> 
<script type="text/javascript"> 
s.pageName=AC.Tracking.pageName(); 
s.channel="www.us.developer" 


peopecopocorxx DO NOT ALTER ANYTHING BELOW THIS LINE | *#**##4#4444447/ 
var s code=s.t();if(s_code)document.write(s_code)</script> 

<!-- End SiteCatalyst code version: H.8. --> 

</div> 


<div id="adcHeader" class="hideOnPrint hidelnXcode"> 
<div id="ssi_Header" class="hidelnXcode unified"> 
<a id="ssi_LibraryTitle" 
href="https://developer.apple.com/library/archive/navigation/" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
navigation/_1&quot;;return this.s_oc?this.s_oc(e):true">Documentation 
Archive</a> 
<a id="ssi_AppleDeveloperConnection" 
href="https://developer.apple.com/" 
onclick="s_objectID=&quot;https://developer.apple.com/_1&quot;;return 
this.s_oc?this.s_oc(e):true">Developer</a> 
<div id="ssi SearchButton" role="button" title="Search">Search</div> 
</div> 
<form id="ssi_SearchMenu" method="get" action="../../../search/" accept- 
charset="utf-8"> 
<label for="adcsearch">Search Documentation Archive</label> 


<input type="search" id="ssi_SearchField" name="q" accesskey="s" 
results="5"> 
</form> 
</div> 


<header id="header"> 
<div id="title" role="banner"> 
<h1>Voices</h1> 
<span id="file links"> 
<a id="PDF link" role="button" tabindex="4" rel="alternate" 
title="Download PDF" class=""><span id="pdf_icon"></span>PDF</a> 
<a id="Companion link" role="button" tabindex="3" title="Download 
Companion File" class=""><span id="companion_icon"></span>Companion 
File</a> 
</span> 
</div> 
<ul id="headerButtons" class="hideOnPrint" role="toolbar"> 
<li id="toc_button" style=""> 
<button tabindex="5" id="table of contents" class="" 
role="checkbox" aria-label="Show Table of Contents"><span 
class="disclosure"></span>Table of Contents</button> 
</li> 
<li id="jumpto_button" style="display:none" role="navigation"><select 
tabindex="6" id="jumpTo"><option value="top">Jump 
To...</option></select></li> 
«li id="downloadSample button" style=""> 
«a id="Sample link" 
href="/library/archive/samplecode/Voices/Voices.zip"» «button 
id="Sample_button">Download Sample Code</button></a> 
</li> 
</ul> 
</header> 
<nav id="tocContainer" tabindex="7" class=""> 
<ul id="toc" role="tree"><li class=" " 
data-aref="//apple_ref/doc/uid/DTS10003699-Intro- 
DontLinkElementID 2"><span class="nodisclosure"></span><span 
class="sectionName"><a 
href="/library/archive/samplecode/Voices/Introduction/Intro.html#//apple_ref/ 
doc/uid/DTS10003699-Intro-DontLinkElementID 2">About 
Voices</a></span></li><li class=" " 
data-aref="//apple ref/doc/uid/DTS10003699-Content Voices css- 
DontLinkElementID 4"><span class="nodisclosure"></span><span 
class="sectionName"><a 
href="/library/archive/samplecode/Voices/Listings/Content Voices css.html#// 
apple ref/doc/uid/DTS10003699-Content Voices css- 
DontLinkElementID 4">Content/Voices.css</a></span></li><li class=" " data- 
aref="//apple ref/doc/uid/DTS10003699-Content Voices html- 
DontLinkElementID 5"><span class="nodisclosure"></span><span 
class="sectionName"><a 
href="/library/archive/samplecode/Voices/Listings/Content Voices html.html#// 
apple ref/doc/uid/DTS10003699-Content Voices html- 
DontLinkElementID_5">Content/Voices.html</a></span></li><li class=" " 


data-aref="//apple_ref/doc/uid/DTS10003699-Content_Voices js- 
DontLinkElementID_6"><span class="nodisclosure"></span><span 
class="sectionName"><a 
href="/library/archive/samplecode/Voices/Listings/Content Voices js.html#// 
apple ref/doc/uid/DTS10003699-Content Voices js- 
DontLinkElementID_6">Content/Voices.js</a></span></li><li class=" " data- 
aref="//apple ref/doc/uid/DTS10003699-Voices wdgt Voices css- 
DontLinkElementID 7"><span class="nodisclosure"></span><span 
class="sectionName"><a 
href="/library/archive/samplecode/Voices/Listings/Voices wdgt Voices css.html# 
//apple ref/doc/uid/DTS10003699-Voices wdgt Voices css- 
DontLinkElementID_7">Voices.wdgt/Voices.css</a></span></li><li class=" " 
data-aref="//apple ref/doc/uid/DTS10003699-Voices wdgt Voices html- 
DontLinkElementID 8"><span class="nodisclosure"></span><span 
class="sectionName"><a 
href="/library/archive/samplecode/Voices/Listings/Voices wdgt Voices html.html 
#//apple_ref/doc/uid/DTS10003699-Voices wdgt Voices html- 
DontLinkElementID_8">Voices.wdgt/Voices.html</a></span></li><li class=" " 
data-aref="//apple ref/doc/uid/DTS10003699-Voices wdgt Voices js- 
DontLinkElementID 9"><span class="nodisclosure"></span><span 
class="sectionName"><a 
href="/library/archive/samplecode/Voices/Listings/Voices wdgt Voices js.html#// 
apple ref/doc/uid/DTS10003699-Voices wdgt Voices js- 
DontLinkElementID_9">Voices.wdgt/Voices.js</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/DTS10003699-RevisionHistory- 
DontLinkElementID 1"><span class="nodisclosure"></span><span 
class="sectionName"><a 
href="/library/archive/samplecode/Voices/History/History.html#//apple_ref/doc/ 
uid/DTS10003699-RevisionHistory-DontLinkElementID 1">Revision 
History</a></span></li></ul> 

</nav> 


<article id="contents" tabindex="0" role="main" class=""> 
<div id="pageNavigationLinks top" class="pageNavigationLinks"> 
<a class="nextLink" rel="next" 

href="../Listings/Content Voices css.html" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
samplecode/Voices/Listings/Content_Voices_css.html_1&quot;;return this.s oc? 
this.s_oc(e):true">Next</a> 

</div> 

<a id="top" name="top"></a> 

<a id="INDEX" href="../index.html" style="display:none;" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
samplecode/Voices/index.html_1&quot;;return this.s oc?this.s oc(e):true"></a> 

<div id="legacyOuterWrapper" role="alert" class="show"><div 
align="center" id="watermark"><div class="legacybox"> 
<hl>Retired Document<span id="LegacyNoticeCloseBox" 
class="closebutton"></span></h1><p><b>Important:</b> 
This sample code may not represent best practices for current development. The 
project may use deprecated symbols and illustrate technologies and techniques 
that are no longer recommended.</p></div></div></div> 

<a name="//apple_ref/doc/uid/DTS10003699" title="Voices"></a><a 
name="//apple_ref/doc/uid/DTS10003699-Intro-DontLinkElementID_2" 
title="Voices"></a> 


<h1 id="pageTitle">Voices</h1><div class="spec_sheet_info_box"><table 
cellspacing="0" class="specbox"><tbody><tr><td 
scope="row"><strong><span style="white-space: nowrap;">Last 
Revision: </span> «/strong» «/td» «td» «div 
class="zSharedSpecBoxHeadList">Version 1.1, 2007-06-25<br>Rearranged to 
encourage asynchronous widget.system usage<br> «span 
class="content_text"><a 
href="../History/History.html#//apple_ref/doc/uid/DTS10003699-RevisionHistory- 
DontLinkElementID 1" data-renderer-version="1" target="_self" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
samplecode/Voices/History/History.html#//apple_ref/do_1&quot;;return this.s oc? 
this.s_oc(e):true">(Full Revision 
History)</a></span><br></div></td></tr> <tr><td 
scope="row"><strong><span style="white-space: nowrap;">Build 
Requirements:</span></strong></td><td><div 
class="zSharedSpecBoxHeadList">Mac OS X 10.4 or 
later</div></td></tr><tr><td scope="row"><strong><span style="white- 
space: nowrap;">Runtime Requirements:</span></strong></td><td><div 
class="zSharedSpecBoxHeadList">Mac OS X 10.4 or 
later</div></td></tr></tbody></table></div> 


<div class="importantbox clear"><aside><a 
name="//apple ref/doc/uid/DTS10003699-Intro-DontLinkElementID 3" 
title="Important"></a><p><strong>Important</strong>&nbsp;This sample 
code may not represent best practices for current development. The project may 
use deprecated symbols and illustrate technologies and techniques that are no 
longer recommended.</p><p></p></aside></div> 

<p>This sample widget speaks the text typed into its text field using the 
widget.system command. Two different approaches are included: one which 
calls widget.system in a synchronous (blocking) fashion, the other in an 
asynchronous (non-blocking) fashion. Note that in the synchronous example, all 
user interaction is halted while speech is performed. The asynchronous example 
is an updated version of the widget found in /Developer/Examples/Dashboard on 
Mac OS X 10.4</p> 


«div id="pageNavigationLinks bottom" class="pageNavigationLinks"> 
«a class="nextLink" rel="next" 

href="../Listings/Content Voices css.html" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
samplecode/Voices/Listings/Content Voices css.html 2&quot;;return this.s oc? 
this.s oc(e):true">Next</a> 

</div><br> 

<div class="copyright"><br><hr><div align="center"><p 
class="content text" lang="en" dir="Itr'» Copyright © 2007 Apple Inc. All 
Rights Reserved. <a 
href="http://www.apple.com/legal/internet-services/terms/site.html" 
target="_blank" 


onclick="s_objectID=&quot;http://www.apple.com/legal/internet-services/terms/ 
site.html_1&quot;;return this.s oc?this.s oc(e):true">Terms of Use</a> | <a 
href="http://www.apple.com/privacy/" target="_blank" 
onclick="s_objectID=&quot;http://www.apple.com/privacy/_1&quot;;return 
this.s oc?this.s oc(e):true">Privacy Policy</a> | Updated: 
2007-06-25</p></div></div> 


<div id="pediaWindow"> 
<div id="pediaHeader"></div> 
<div id="pediaBody"></div> 
</div> 
</article> 


<script charset="utf-8" 
src="../../../Resources/1282/JavaScript/lib/prototype.js" ></script> 
<script src="../../../Resources/1282/JavaScript/library.js"></script> 


</body></html><html><head> 
<meta name="ROBOTS" content="NOINDEX, NOFOLLOW"> 

<meta id="book-resource-type" name="book-resource-type" 
content="Technical Note"> 

<meta id="book-title" name="book-title" content="Command-Shift- 
Number Keys"> 

<meta id="book-root" name="book-root" content="./"> 

<meta id="devcenter" name="devcenter" content="Mac Dev Center"> 

<meta id="devcenter-url" name="devcenter-url" 
content="http://developer.apple.com/devcenter/mac"> 

<meta id="reflib" name="reflib" content="Documentation Archive"> 

<meta id="book-assignments" name="book-assignments" 
content="{Type/Technical Note}"> 

<meta scheme="apple_ref" id="identifier" name="identifier" 
content="//apple ref/doc/uid/DTS10002587"> 

<meta id="document-version" name="document-version" 
content="1.0.1"> 

<meta id="build" name="build" 
content="cle4c7a89af8f899a21cfa81fc33ba42"> 

<meta id="description" name="description" content="0S01."> 

<meta id="resources-uri" name="resources-uri" 
content="../../Resources/1282/"> 

<meta id="Generator" name="Generator" content="Gutenberg Static 
e43202ea08"> 

<meta id="Copyright" name="Copyright" content="Copyright 2018 
Apple Inc. All Rights Reserved."> 

<meta name="viewport" content="width=device-width, 

initial-scale=1, maximum-scale=1"> 

<meta id="platforms" name="platforms" content="OS X"> 
<link rel="stylesheet" type="text/css" 
href="../../Resources/1282/CSS/screen.css"> 
<link rel="stylesheet" type="text/css" 
href="../../Resources/1282/CSS/feedback.css"> 


<link rel="stylesheet" href="../../adcstyle.css" type="text/css" id="custom"> 
<link rel="stylesheet" href="../../style.css" type="text/css" id="custom"> 


<title>Technical Note OS01: Command-Shift-Number Keys</title> 


<meta name="keywords" content="Mac OS 8 Command-shift-number 1 2 3 4 
FKEY"> 

<meta name="Description" content="Technical Note OSO1: This Technical Note 
lists some of the 

Command-Shift-Number combinations that are automatically 

captured by GetNextEvent and are implemented with 'FKEY' 

resources."> 


<meta name="categories" content="Operating System"> 


<meta name="week-posted" content="Feb 25, 1985 - Mar 1, 1985"> 


<link rel="stylesheet" href="../../css/adcstyle.css" type="text/css" 
id="custom"><script language="JavaScript" type="text/javascript" 
src="../../Resources/1282/JavaScript/adc.js"></script> 

</head> 


<body bgcolor="#FFFFFF" id="StaticPage" class=""><a 
name="//apple_ref/doc/uid/DTS10002587" title="Command-Shift-Number 
Keys"></a> 


<div id="adcHeader" class="hideOnPrint hidelnXcodeSC"> 
<div id="ssi_Header" class="hidelnXcodeSC unified"> 
<a id="ssi_LibraryTitle" href="../../navigation/">Documentation 
Archive</a> 
<a id="ssi_AppleDeveloperConnection" 
href="https://developer.apple.com/">Developer</a> 
<div id="ssi_SearchButton" role="button" 
title="Search">Search</div> 
</div> 
«form id="ssi SearchMenu" method="get" action="../../search/" 
accept-charset="utf-8"> 
<label for="adcsearch">Search Documentation Archive</label> 
<input type="search" id="ssi_SearchField" name="q" 
accesskey="s" results="5"> 
</form> 
</div> 
<header id="header"> 


<div id="title" role="banner"> 
<h1>Command-Shift-Number Keys</h1> 
<span id="file_links"> 
<a id="PDF link" role="button" tabindex="4" rel="alternate" 
title="Download PDF"><span id="pdf_icon"></span>PDF</a> 
<a id="Companion_link" role="button" tabindex="3" 
title="Download Companion File"><span 
id="companion_icon"></span>Companion File</a> 
</span> 
</div> 
<ul id="headerButtons" class="hideOnPrint" role="toolbar"> 
<li id="toc_button" style="display:none"> 
<button tabindex="5" id="table_of_contents" class="" 
role="checkbox" aria-label="Show Table of Contents"> 
<span class="disclosure"></span>Table of Contents</button> 
</li> 
<li id="jumpto_button" style="display:none" role="navigation"> 
«select tabindex="6" id="jumpTo"> 
<option value="top">&lt;&gt;</option> 
</select> 
</li> 
«li id="downloadSample button" style="display:none"> 
<a id="Sample link"><button id="Sample_button">Download 
Sample Code</button></a> 
</li> 
</ul> 
</header> 
<nav id="tocContainer" class="" tabindex="7"> 
<ul id="toc" role="tree"></ul> 
</nav> 
<article id="contents" class=""> 
<div id="technical"> 
<a name="top"></a> 
<!-- top of header marker comment --> 
<!-- begin header information --><p><a 
href="http://developer.apple.com/">ADC Home</a> &gt; <a 
href="../../referencelibrary/index.html">Reference Library</a> &gt; <a 
href="../../technicalnotes/index.html">Technical Notes</a> &gt; <a 
href="../../technicalnotes/LegacyTechnologies/index.html">Legacy 
Documents</a> &gt; <a 
href="../../technicalnotes/LegacyTechnologies/idxMacOS9Earlier-date.html">Mac 
OS 9 &amp; Earlier</a> &gt; </p><div style="width:100%; 
position:fixed;"><div align="center" id="watermark" style="position: relative; 
margin-left:auto; margin-right:auto; z-index:20; width:500px;"><div 
class="legacybox"><hl>Legacy Document<span class="closebutton"><a 
href="javascript:closeWatermark()"><img 
src="../../Resources/1282/Images/closebutton.png" width="14" height="14" 
border="0" alt="close button"></a></span></h1> 


<p><strong>Important: </strong>This document is part of the Legacy section 
of the ADC Reference Library. This information should not be used for new 
development.</p> 


<div class="reflibtopic"> 


<p>Current information on this Reference Library topic can be found 
here:</p> 

<ul> 

<li><a 

href="http://developer.apple.com/referencelibrary/Carbon/idxHumaninterfaceToo 
Ibox-date.html" target="_blank">Carbon &gt; Human Interface 
Toolbox</a></li> 

</ul> 
</div> 


</div></div></div><!-- end_header_information --> 

<!-- bottom_of_header_marker_comment --> 

<!-- top of titles marker comment --><center><table width="600" 
cellpadding="0" cellspacing="0" border="0"> 

<tbody><tr><td align="left" scope="row"> 

<hl> 

<div id="pagehead">Technical Note OS01</div> 

<div id="pageheadsub">Command-Shift-Number Keys</div> 
</h1> 

</td></tr></tbody></table></center><!-- bottom_of titles marker_comment 
--> 


<center><table border="0" cellspacing="1" width="600"><tbody><tr><td 
align="left"> 
<!-- begin_header_box --> 
<table width="600" cellpadding="0" cellspacing="0" border="0"> 
<tbody><tr> 
<td width="300" valign="top" align="left" scope="row"> 
<table border="0" width="300" cellpadding="0" cellspacing="0"> 
<tbody><tr> 
<td width="300" align="left"> <img src="images/tnmenutop.gif" alt="" 
align="bottom" width="300" height="7"></td> 
</tr> 
<tr bgcolor="#e6e6e6"> 
<td background="images/tnmenubody.gif" width="300" 
align="left"> 


<span id="menutitle"> 
CONTENTS 
<br> 
<br> 
</span> 
</td> 
</tr> 
<tr bgcolor="#e6e6e6"> 
<td background="images/tnmenubody.gif" width="300" 
align="left"> 
<!-- begin_toc --> 


<p id="menutext"> 
<a href="#Section1">Introduction</a><br><br> 


<a href="#References">References</a><br> 
<br> 


<a href="#Downloads">Downloadables</a></p> 
<!-- end_toc --> 
</td> 
</tr> 
<tr> 
<td width="300" align="left" scope="row"> 
<img src="images/tnmenubottom.gif" alt="" width="300" 
height="16"> 
</td> 
</tr> 
</tbody></table> 
</td> 
<td width="300" valign="top" align="left"> 
<!-- begin_intro_text --> 
<p id="introtext"></p> 
<!-- end_intro_text --> 
<!-- begin_date --> 
<h3 align="center">Mar 01 1985</h3> 
<!-- end_date --> 
</td> 
</tr> 
</tbody></table> 
<!-- end_table_box --> 
<br><br> 
<hr width="500" align="center"> 
<br><br> 


<!-- begin_content --> 
<p><a name="Sectionl"></a></p> 
<h2>Introduction</h2> 
<p> 
In the standard system, there are two Command-Shift-number key combinations 
that are automatically captured and processed by GetNextEvent. 
The combinations are:</p> 


<p>Command-Shift-1 Eject internal disk</p> 
<p>Command-Shift-2 Eject external disk</p> 


<p>Numbers from 3 to 9 are also captured by <code>GetNextEvent</code>, 
but are processed by 

calling <code>'FKEY'</code> resources. You can implement your own actions 
for Command-Shift-number 

combinations for numbers 5 to 9 by defining your own <code>'FKEY'</code> 
resource. The routine must 

have no parameters. The ID of the resource must correspond to the number you 
want the 

routine to respond to. For example, if you want to define an action for Command- 
Shift-8, 

you would create an <code>'FKEY'</code> resource with an ID of 8. The 
<code>'FKEY'</code> resource should contain 


the code that you want to execute when the key is pressed.</p> 


<p>The following Command-Shift-number key combinations are implemented 
with <code>'FKEY'</code> resources in the standard System file.</p> 


<p>Command-Shift-3</p> 


<p>Save current screen as MacPaint file named Screen 0, Screen 1, ... Screen 9 
(Works in one-bit mode only on Mac Il)</p> 


<p>Command-Shift-4 Print the active window (to an ImageWriter)</p> 


<p>(with Caps Lock on) Print the entire screen (to an ImageWriter)</p> 
<p><a href="#top">Back to top</a></p> 

<a name="References"></a> 

<h2>References</h2> 


<p>The Toolbox Event Manager</p> 


<p><a href="#top">Back to top</a></p> 
<p><a name="Downloads"></a></p> 


<h2>Downloadables</h2> 


<table border="0" cellpadding="3" width="100%"> 
<tbody><tr> 
<td width="50" align="left"> 
<p align="center"><img src="images/acrobatsmall.gif" width="22" 
height="23" align="middle" alt="Acrobat gif"></p> 
</td> 
<td align="left"> 
<p>Acrobat version of this Note (40K).</p> 
</td> 
<td width="60" align="left"> 
<p><a href="pdf/os 01.pdf">Download</a></p> 
</td> 
</tr> 


</tbody></table> 
<br> 


<p><a href="#top">Back to top</a></p> 
</td></tr></tbody></table></center> 
<!-- end_content --> 
<!-- begin_footer_information --> 


<div id="globalfooter" class="hidelnXcode hideOnPrint"> 
<div class="gf-sosumi"> 
<p>Copyright © 2016 Apple Inc. All rights reserved.</p> 
<ul class="piped"> 
<li><a 
href="http://www.apple.com/legal/internet-services/terms/site.html" class="first" 
target="_blank">Terms of Use</a></li> 


<li><a href="http://www.apple.com/privacy/" 
target="_blank">Privacy Policy</a></li> 
</ul> 
</div> 
</div><!--/globalfooter--> 
<!-- end_footer_information --> 


</div> 
</article> 


<script type="text/javascript" 
src="../../Resources/1282/JavaScript/lib/prototype.js"></script> 
<script type="text/javascript" 
src="../../Resources/1282/JavaScript/library.js"></script> 
<script type="text/javascript" 
src="../../Resources/1282/JavaScript/feedback.js"></script> 


<div id="blackout"> 
<div id="preload"></div> 
</div><div id="modal" aria-hidden="true"> 
<div id="closebox" tabindex="0" aria-label="Close feedback form" 
role="button"></div> 
<div id="sending" class="hidden"> 
<h2 tabindex="0">Sending feedback...</h2> 
<div id="sending img"></div> 
</div> 
<div id="error" class="hidden"> 
<h2 tabindex="0">We’re sorry, an error has occurred.</h2> 
<p>Please try submitting your feedback later.</p> 
<div id="error icon"></div> 
</div> 
<div id="success" class="hidden"> 
<h2 tabindex="0">Thank you for providing feedback!</h2> 
<p>Your input helps improve our developer documentation.</p> 
<div id="thank you icon"></div> 
</div> 


<form id="feedback" action="#" method="post"> 
<div class="left-leaf"> 


<h2 id="helpful title" data-asterisk="al" tabindex="0">How helpful is 


this document?</h2> 
«sup id="al" class="asterisk" aria-hidden="true">*</sup> 


<div id="star_group" role="radiogroup" aria-required="true"> 
<label> 


<input class="radio" type="radio" name="helped" value="1"> 


Very helpful 
</label> 


<label> 
<input class="radio" type="radio" name="helped" value="2"> 
Somewhat helpful 
</label> 
<label> 
<input class="radio" type="radio" name="helped" value="3"> 
Not helpful 
</label> 
</div> 
</div> 
<div class="right-leaf"> 
<h2>How can we improve this document?</h2> 
<div id="improve" class="checkboxes"> 
<label> 
<input type="checkbox" name="typo"> 
Fix typos or links 
</label> 
<label> 
<input type="checkbox" name="infolncorrect"> 
Fix incorrect information 
</label> 
<label> 
<input type="checkbox" name="needs examples"> 
Add or update code samples 
</label> 
<label> 
<input type="checkbox" name="needs_art"> 
Add or update illustrations 
</label> 
<label> 
<input type="checkbox" name="missinginfo"> 
Add information about... 
</label> 
</div> 
</div> 


<textarea id="comment" name="problem" cols="70" rows="8" 
placeholder="Please tell us more about your experience with this document" 
data-asterisk="a2" required=""></textarea> 
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<a name="Section1"></a> 
<h2>Introduction</h2> 
<p>Managers to avoid abusing, and the type of abuse:</p> 
<p>1) The Resource Manager is <b>not</b> a database.</p> 
<p>2) The TextEdit package is <b>not</b> a word processor.</p> 
<p>3) The List Manager is <b>not</b> a spreadsheet.</p> 
<p>4) The Dialog Manager is <b>not</b> a user interface.</p> 
<p><a href="#top">Back to top</a></p> 
<a name="Section2"></a><h2>No free database</h2> 
<p>After using the Resource Manager for a short time, its virtues become 


apparent: 
it is very flexible, it is easy to use, it gives disk based I/O with no extra calls, 


data can be extracted by either name or ID number, and the data is stored 
transparently 

so the caller can pretend the data is always available in a virtual memory 
fashion. 

With such wide ranging advantages, it would seem that the Resource Manager 
should 

be used for everything. It should be apparent that the TANSTAAFL (There Ain't 
No 

Such Thing As A Free Lunch) philosophy applies to the Resource Manager as well. 
If overextended, the Resource Manager will become slow and unusable.</p> 


<p>The Resource Manager is not a database, nor is it a good way to store user 
data. 

Although it can be used to store very small amounts of data, such as 
configuration data, 

and features some of the same characteristics of databases in general, the 
Resource Manager 

is a specialized tool designed specifically for the types of things that the 
Macintosh System needs. 

Its main virtue for system use is that a large variety of data can be stored on 
disk, and accessed 

when needed. This is a primitive form of virtual memory which extends the 
power of the system 

beyond what the RAM supplies. Remembering that the Resource Manager was 
written in an era of 

128K RAM, it should be apparent that it is optimized to use as little RAM as 
possible.</p> 


<p>The Resource Manager uses a simple data structure for accessing the data 
in the 

file. Examining the Resource Manager file format can show some of the tradeoffs 
expected. 

For instance, there is a linearly accessed table which describes all of the possible 
resource 

types that are in the current file. Without too much thought it should be apparent 
that if a 

file is created with thousands of different resource types then access to those 
resources 

will be slow. The reason? Each access requires scanning a linear array. There is 
no 

hashing technique used on the resource types.</p> 


<p>There is a similar linear table for the resource IDs themselves. Based on the 
previous discussion it should also be apparent that if there are thousands of 
resources of a specific type that the access time will become much larger. It 

will be imperceptible on a single access of a resource, but for thousands of 
accesses to the resource file the time spent traversing the linear list will 

impact the overall speed of the program. The user will not be pleased.</p> 


<p>Increasing the slowness by having too many resources as well as too many 
types 

will encourage the user to file the program in a ground based circular storage 
facility.</p> 


<p>As stated in<a href="../tb/tb_18.html">M.TB.MaxResinFile</a>, there is a 
limit of 

about 2700 resources in a given file due to the way the resources are stored. The 
performance penalty 

will arrive sooner, and the dividing line for where it is "too slow" is a personal 
preference. As a 

rule of thumb, if the program has the ability to store more than about 500 
resources total (both IDs 

and types), then consideration should be given to using the Data Fork instead. In 
particular, if 

the program allows the user to create data files, do not use the Resource 
Manager to store the 

user data. The users will always overextend the use of a program. Plan for it, and 
avoid 

making obviously bad decisions. For large amounts of data, the File Manager is 
the place 

to look. If the program wants to allow simultaneous (multi-user) access with read 
and 

write privileges to data files, then do not use the Resource Manager. Because it 
caches data, the Resource Manager cannot be relied upon as a multi-user 
database - even for small amounts of data. This is because there is no 

way to tell the Resource Manager its cache is invalid. x«/p» 


<p>Don't be fooled by a convenient interface. The Resource Manager is not a 
database, nor is it a file system.</p> 


<p><a href="#top">Back to top</a></p> 


<a name="Section3"></a> 
<h2>Words to live by</h2> 


<p>Looking at the TextEdit package can give the impression that there is a full 
featured word processing system built in. This is even more true now that 
TextEdit has 

been extended to support various styles and fonts. Unfortunately, appearances 
are deceiving, 

and TextEdit is not up to the job of being a word processor. Looking through the 
documentation 

shows that there is a 32,767 character limit on the text in a TextEdit record. The 
<code>teLength</code> is 

defined as an <code>Integer</code>. Another more subtle limit is the drawing 
limit of the rectangles 

surrounding the text. The <code>destRect</code> and 
<code>viewRect</code> both surround the complete 

TextEdit record. Using some rather rough approximations, there is an upper limit 
of about 

40 pages of text that can be supported in the QuickDraw rectangle. This is quite 
a lot 

for some applications, but is not very many when looking at the job typically 
required of a word processor. Users do not enjoy breaking their documents 

into multiple pieces.</p> 


<p>There are some other programmatic limitations, not the least of which is 


performance. TextEdit will become quite sluggish with large blocks of data. After 
2,000-4,000 

characters have been stored in a TextEdit record, the performance will have 
slowed to an unacceptable level. 

It is notable that the <code>lineStarts</code> array is a linear array of offsets 
into the edit record. If the 

data towards the end of the data record (high in the record) changes, the offsets 
have to be changed. 

This can involve updating thousands of <code>Integer</code> offsets for every 
character typed. If the 

different font, size and style information is tacked on top of all that, the 
performance can be 

expected to suffer with large blocks of text. Make no mistake about it, a full 
Macintosh style 

word processor is not an easy thing to write. TextEdit was not designed to handle 
large documents. It was designed as a simple field editor for the Dialog Manager, 
and extended from there. It was never intended to handle the large jobs 
expected 

of a word processor.</p> 


<p>In order to perform the operations required of a word processor it is 
necessary 

to use QuickDraw extensively. The expected Macintosh selection approach with 
autoscrolling, 

typing over selected text, cut/copy/paste, and so on are best implemented using 
QuickDraw directly. 

How the text is stored internally is the primary determining factor on how the 
word processor 

will perform.</p> 


<p>Don't be fooled by how easy it is to implement simple editing in an 
application. TextEdit is not a word processor.</p> 


<p><a href="#top">Back to top</a></p> 


<a name="Section4"></a> 
<h2>Checking lists twice</h2> 


<p>The List Manager appears to be a cell oriented display tool, allowing the 
easy 

creation of a spreadsheet interface using system calls. The rich interface to the 
manager 

makes it easy to handle arbitrary lists of data. Or does it? Although the List 
Manager is very 

flexible, easy to use, and general enough to handle graphic elements, its 
performance becomes 

unacceptable with relatively modest amounts of data. A one-dimensional list (like 
the files 

list in StdFile) can be done very well using the List Manager, but with several 
thousand 

items in the list, the performance may not be sufficient. This rarely happens in 
StdFile 

of course, and StdFile was the father of the List Manager. Here again, the tool 
was 


designed with a specific concept in mind, not to be the ultimate tool for handling 
any possible arbitrary data. A two-dimensional list of data will become too slow 
to use with an array as small as 10x100. This can hardly be expected to satisfy 
the user of a spreadsheet, since one "power" criteria is always the number 

of cells available.</p> 


<p>Why so slow? As above, examining the data structures used by the List 
Manager 

can tell a lot about the expected performance and limitations. Notably the 
<code>cellArray</code> 

used to offset to each cell's data is an old friend, a linear array of 
<code>Integer</code> offsets. 

It should come as no Surprise that inserting or deleting data from the middle of 
this array is slow. 

In order to do those functions the List Manager has to update the 
<code>Integer</code> offsets 

in the array each time. It has to step through each element on the linear array 
of offsets which will take some time on several thousand elements.</p> 


<p>The <code>maxindex</code> field of the ListRec is also notable since it is 
an 

<code>Integer</code> as well. The lists of data can be no more than 32K bytes 
in 

size, which could be somewhat limiting to a user.</p> 


<p>In addition, the List Manager is very general purpose, making it necessary 
for 

it to protect itself from bad data whenever possible. It needs to check the 
bounds of any rectangles it uses for example. It tries to minimize drawing out 
of bounds, so it checks each cell as it is drawn to be sure that it is on 

screen. Extra validity checks take some small, but finite, time. As the number 
of elements grows, the time adds up until it becomes a performance problem. 
Another limitation brought out by the data structure is the 
<code>listDefProc</code>, the list definition procedure. Since the List Manager 
is 

designed to be as general purpose as possible, it was necessary to add the 
ability to plug in a new defproc. This has ramifications for speed, however, 
since all drawing has to go through the bottleneck of the defproc. It won't 

cost much each time, but it will add up over a large number of cells.</p> 


<p>In order to get high performance out of this type of display, it is generally 
necessary to have as much precalculated as possible. This usually means having 
data structures which maintain themselves as much as possible, and which do 
not 

require changing anything outside of their single cell, thus avoiding impacting 
the entire display. Linear arrays don't come under this category, since any 
change impacts all the other cell data in the list. To create a high 
performance spreadsheet it is usually necessary to go to the QuickDraw level 
inside of a standard window. It is not typically necessary to be fully general 
for a specific type of data, so the performance can be improved merely by 
knowing the type of data expected. To handle large lists of data, the data 
should be stored in powerful data structures, and displayed with custom 
routines that know the best way to draw the data.</p> 


<p>Don't be fooled by the richness and general purpose interface to the List 
Manager. The List Manager is not a spreadsheet.</p> 


<p><a href="#top">Back to top</a></p> 


<a name="Section5"></a> 
<h2>Dialog with the Devil</h2> 


<p>The Dialog Manager is very attractive. It looks like it will handle windows 
automatically with no programmer intervention, and can handle a wide variety of 
elements. It seems to handle controls, static text, editable text, and provides 

a way to display graphic elements as well. It must be the best possible world 
since the interface is very straightforward, and so much is done for the 

caller. At last, a superbly general purpose manager that can be used for any 
interface. Suddenly, reality rears its ugly head again, and it is interesting 

to note that this free lunch actually requires more work than doing the same 
job using the Window Manager, QuickDraw, TextEdit, and the Control Manager. 
Why? There is a hidden cost in terms of getting the Dialog Manager to do 
exactly the desired task. Here again, if the end result is supposed to be a 
simple dialog with a few controls, the Dialog Manager is suited to the job. 

That is what it was written to do. It was not designed as a way to handle the 
full interface for applications.</p> 


<p>As an example of a hidden cost, what if the interface requires that the 
program 

be able to handle a disk inserted event? If this is part of a 
<code>ModalDialog</code>, 

that requires passing a special <code>filterProc</code> to the dialog when it is 
called. 

It is now necessary to fully understand how the proc gets called, what is legal, 
and 

what the proc is required to do. That may not be too hard, but it is time spent on 
something that has nothing to do with getting the job done; it is only time spent 
understanding how the Dialog Manager works.</p> 


<p>Another example is adding something to a dialog which requires special 
setup 

and update routines. Here again, it is not too hard to figure out, but it is 

time spent trying to tell the Dialog Manager what should be done. There are 
literally hundreds of these special cases and tough, small problems when trying 
to extend a dialog past a simple interface. Hundreds of Mac programmers have 
wasted hundreds (thousands?) of hours finding ways to coerce the Dialog 
Manager 

into running a window in a special way.</p> 


<p>How about adding a special control to a dialog? Seems straightforward... 
How 

about making it modeless instead? How about moving some items in the dialog 
off 

screen? How about moving an EditText item off screen? How about wanting to 
change the dialog template before the dialog is used? How about all of the 
above all at the same time?</p> 


<p>How about skipping it and using the Window Manager instead?</p> 


<p>There are a number of performance penalties for large dialogs as well. A 
dialog 

with 50 radio buttons will be unacceptably slow. It should be noted that the 
Dialog Manager cannot know the desired purpose of the buttons, so it cannot set 
the button, nor clear another in the same set. In order to implement the actual 
radio button aspect of a set of controls, it has to be done by the calling 
program. At this point, the only thing the Dialog Manager is handling is the 
creation and drawing of the controls, which can easily be done with 
<code>GetNewControl</code> and <code>DrawControls</code>. The Dialog 
Manager actually 

gets in the way of a more complex interface. Looking into the data structures 
shows that the list of items in a dialog is a linear list. Also of note is that 

there are no offsets to the various items! This is significant because it means 
that the Dialog Manager has to drive through the entire list of items for every 
single operation it performs. If it gets an update event it has to traverse the 
list. If it gets a mouse event it has to traverse the list. This cannot be 

expected to be fast with 100 items.</p> 


<p>Another performance problem for some programmers is the simple drawing 
scheme 

used by the Dialog Manager. If a dialog has some items that are offscreen, they 
get drawn during update events anyway. The Dialog Manager will traverse the 
list and draw each item, whether it is on screen or not. This comes from the 
original design of the Dialog Manager, in that it was never intended to handle 
hundreds of items, or items off screen.</p> 


<p>Some rules of thumb: If there are more than 20 items in the dialog it should 
be 

a standard window. If a complicated control like a scroll bar is needed, it 

should be a standard window. If there are items offscreen, it should be a 
standard window. If there is a pictorial indicator like a progress indicator, 

it should be a standard window. If it is a modeless dialog it should be a 

standard window. If any of the items are movable in the dialog, it should be a 
standard window. If it is necessary to use a <code>filterProc</code> to add 
functionality, it should be a standard window. If in doubt, it should probably 

be a standard window.</p> 


<p>Handling a dialog with the Window Manager is very straightforward, much 
more so 

than trying to get around the Dialog Manager. There is the standard main event 
loop, 

and a conventional case statement to handle the events of interest. If there are 
controls 

in the window, they are easily handled with Control Manager calls. Any special 
items can 

be added to the case statement with no tricks. Overall there is more code to 
write, but 

the code is much less complex (read as: easier to figure out, easier to debug, 
easier 

to maintain). In addition, when extra items have to be added to the window, 
there is 

an easy-to-find, logical place to add the code. With the Dialog Manager there 
may 


be hidden difficulties.</p> 


<p>The Dialog Manager is very powerful, but to use the power it is necessary to 
use all sorts of hooks, procs, special items, and special calling sequences. As 
expected, only the interfaces to these things are described in <i>Inside 
Macintosh</i>. 

The sequence of events is the costly part. For an example of how to add a 
<code>userltem</code> to a dialog, 

examine <a href="../tb/tb_27.html">M.TB.DialogUserltems</a>. Note that it is 
not 

particularly simple to understand. Contrast that with the 
<code>FillRect/FrameRect</code> calls in the 

code that handles update events in a normal window.</p> 


<p>The Window Manager is more powerful than the Dialog Manager. The Dialog 
Manager 

uses the Window Manager. The Window Manager is much more straightforward 
to use since it follows 

the conventional Macintosh event model. That model is easier to understand and 
easier to extend. 

There are more calls to make, but the overall use is much simpler. There are 
very few special 

tricks needed to make any conceivable interface in a window.</p> 


<p>Don't be lured in by the "powerful" Dialog Manager calls, tricky hooks, and 
filter procedures. The Dialog Manager is not a user interface.</p> 

<p><a href="#top">Back to top</a></p> 
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<a name="Section1"></a> 
<h2>Introduction</h2> 


<p>Managers to avoid abusing, and the type of abuse:</p> 


<p>1) The Resource Manager is <b>not</b> a database.</p> 
<p>2) The TextEdit package is <b>not</b> a word processor.</p> 
<p>3) The List Manager is <b>not</b> a spreadsheet.</p> 


<p>4) The Dialog Manager is <b>not</b> a user interface.</p> 
<p><a href="#top">Back to top</a></p> 
<a name="Section2"></a><h2>No free database</h2> 


<p>After using the Resource Manager for a short time, its virtues become 
apparent: 

it is very flexible, it is easy to use, it gives disk based I/O with no extra calls, 
data can be extracted by either name or ID number, and the data is stored 
transparently 

so the caller can pretend the data is always available in a virtual memory 
fashion. 

With such wide ranging advantages, it would seem that the Resource Manager 
should 

be used for everything. It should be apparent that the TANSTAAFL (There Ain't 
No 

Such Thing As A Free Lunch) philosophy applies to the Resource Manager as well. 
If overextended, the Resource Manager will become slow and unusable.</p> 


<p>The Resource Manager is not a database, nor is it a good way to store user 
data. 

Although it can be used to store very small amounts of data, such as 
configuration data, 

and features some of the same characteristics of databases in general, the 
Resource Manager 

is a specialized tool designed specifically for the types of things that the 
Macintosh System needs. 

Its main virtue for system use is that a large variety of data can be stored on 
disk, and accessed 

when needed. This is a primitive form of virtual memory which extends the 
power of the system 

beyond what the RAM supplies. Remembering that the Resource Manager was 
written in an era of 

128K RAM, it should be apparent that it is optimized to use as little RAM as 
possible.</p> 


<p>The Resource Manager uses a simple data structure for accessing the data 
in the 

file. Examining the Resource Manager file format can show some of the tradeoffs 
expected. 

For instance, there is a linearly accessed table which describes all of the possible 
resource 

types that are in the current file. Without too much thought it should be apparent 
that if a 

file is created with thousands of different resource types then access to those 
resources 

will be slow. The reason? Each access requires scanning a linear array. There is 
no 


hashing technique used on the resource types.</p> 


<p>There is a similar linear table for the resource IDs themselves. Based on the 
previous discussion it should also be apparent that if there are thousands of 
resources of a specific type that the access time will become much larger. It 

will be imperceptible on a single access of a resource, but for thousands of 
accesses to the resource file the time spent traversing the linear list will 

impact the overall speed of the program. The user will not be pleased.</p> 


<p>Increasing the slowness by having too many resources as well as too many 
types 

will encourage the user to file the program in a ground based circular storage 
facility.</p> 


<p>As stated in<a href="../tb/tb_18.html">M.TB.MaxResInFile</a>, there is a 
limit of 

about 2700 resources in a given file due to the way the resources are stored. The 
performance penalty 

will arrive sooner, and the dividing line for where it is "too slow" is a personal 
preference. As a 

rule of thumb, if the program has the ability to store more than about 500 
resources total (both IDs 

and types), then consideration should be given to using the Data Fork instead. In 
particular, if 

the program allows the user to create data files, do not use the Resource 
Manager to store the 

user data. The users will always overextend the use of a program. Plan for it, and 
avoid 

making obviously bad decisions. For large amounts of data, the File Manager is 
the place 

to look. If the program wants to allow simultaneous (multi-user) access with read 
and 

write privileges to data files, then do not use the Resource Manager. Because it 
caches data, the Resource Manager cannot be relied upon as a multi-user 
database - even for small amounts of data. This is because there is no 

way to tell the Resource Manager its cache is invalid.</p> 


<p>Don't be fooled by a convenient interface. The Resource Manager is not a 
database, nor is it a file system.</p> 


<p><a href="#top">Back to top</a></p> 


<a name="Section3"></a> 
<h2>Words to live by</h2> 


<p>Looking at the TextEdit package can give the impression that there is a full 
featured word processing system built in. This is even more true now that 
TextEdit has 

been extended to support various styles and fonts. Unfortunately, appearances 
are deceiving, 

and TextEdit is not up to the job of being a word processor. Looking through the 
documentation 

shows that there is a 32,767 character limit on the text in a TextEdit record. The 
<code>teLength</code> is 


defined as an <code>Integer</code>. Another more subtle limit is the drawing 
limit of the rectangles 

surrounding the text. The <code>destRect</code> and 
<code>viewRect</code> both surround the complete 

TextEdit record. Using some rather rough approximations, there is an upper limit 
of about 

40 pages of text that can be supported in the QuickDraw rectangle. This is quite 
a lot 

for some applications, but is not very many when looking at the job typically 
required of a word processor. Users do not enjoy breaking their documents 

into multiple pieces.</p> 


<p>There are some other programmatic limitations, not the least of which is 
performance. TextEdit will become quite sluggish with large blocks of data. After 
2,000-4,000 

characters have been stored in a TextEdit record, the performance will have 
slowed to an unacceptable level. 

It is notable that the <code>lineStarts</code> array is a linear array of offsets 
into the edit record. If the 

data towards the end of the data record (high in the record) changes, the offsets 
have to be changed. 

This can involve updating thousands of <code>Integer</code> offsets for every 
character typed. If the 

different font, size and style information is tacked on top of all that, the 
performance can be 

expected to suffer with large blocks of text. Make no mistake about it, a full 
Macintosh style 

word processor is not an easy thing to write. TextEdit was not designed to handle 
large documents. It was designed as a simple field editor for the Dialog Manager, 
and extended from there. It was never intended to handle the large jobs 
expected 

of a word processor.</p> 


<p>In order to perform the operations required of a word processor it is 
necessary 

to use QuickDraw extensively. The expected Macintosh selection approach with 
autoscrolling, 

typing over selected text, cut/copy/paste, and so on are best implemented using 
QuickDraw directly. 

How the text is stored internally is the primary determining factor on how the 
word processor 

will perform.</p> 


<p>Don't be fooled by how easy it is to implement simple editing in an 
application. TextEdit is not a word processor.</p> 


<p><a href="#top">Back to top</a></p> 


<a name="Section4"></a> 
<h2>Checking lists twice</h2> 


<p>The List Manager appears to be a cell oriented display tool, allowing the 
easy 


creation of a spreadsheet interface using system calls. The rich interface to the 
manager 

makes it easy to handle arbitrary lists of data. Or does it? Although the List 
Manager is very 

flexible, easy to use, and general enough to handle graphic elements, its 
performance becomes 

unacceptable with relatively modest amounts of data. A one-dimensional list (like 
the files 

list in StdFile) can be done very well using the List Manager, but with several 
thousand 

items in the list, the performance may not be sufficient. This rarely happens in 
StdFile 

of course, and StdFile was the father of the List Manager. Here again, the tool 
was 

designed with a specific concept in mind, not to be the ultimate tool for handling 
any possible arbitrary data. A two-dimensional list of data will become too slow 
to use with an array as small as 10x100. This can hardly be expected to satisfy 
the user of a spreadsheet, since one "power" criteria is always the number 

of cells available.</p> 


<p>Why so slow? As above, examining the data structures used by the List 
Manager 

can tell a lot about the expected performance and limitations. Notably the 
<code>cellArray</code> 

used to offset to each cell's data is an old friend, a linear array of 
<code>Integer</code> offsets. 

It should come as no Surprise that inserting or deleting data from the middle of 
this array is slow. 

In order to do those functions the List Manager has to update the 
<code>Integer</code> offsets 

in the array each time. It has to step through each element on the linear array 
of offsets which will take some time on several thousand elements.</p> 


<p>The <code>maxindex</code> field of the ListRec is also notable since it is 
an 

<code>Integer</code> as well. The lists of data can be no more than 32K bytes 
in 

size, which could be somewhat limiting to a user.</p> 


<p>In addition, the List Manager is very general purpose, making it necessary 
for 

it to protect itself from bad data whenever possible. It needs to check the 
bounds of any rectangles it uses for example. It tries to minimize drawing out 
of bounds, so it checks each cell as it is drawn to be sure that it is on 

screen. Extra validity checks take some small, but finite, time. As the number 
of elements grows, the time adds up until it becomes a performance problem. 
Another limitation brought out by the data structure is the 
<code>listDefProc</code>, the list definition procedure. Since the List Manager 
is 

designed to be as general purpose as possible, it was necessary to add the 
ability to plug in a new defproc. This has ramifications for speed, however, 
since all drawing has to go through the bottleneck of the defproc. It won't 

cost much each time, but it will add up over a large number of cells.</p> 


<p>In order to get high performance out of this type of display, it is generally 
necessary to have as much precalculated as possible. This usually means having 
data structures which maintain themselves as much as possible, and which do 
not 

require changing anything outside of their single cell, thus avoiding impacting 
the entire display. Linear arrays don't come under this category, since any 
change impacts all the other cell data in the list. To create a high 
performance spreadsheet it is usually necessary to go to the QuickDraw level 
inside of a standard window. It is not typically necessary to be fully general 
for a specific type of data, so the performance can be improved merely by 
knowing the type of data expected. To handle large lists of data, the data 
should be stored in powerful data structures, and displayed with custom 
routines that know the best way to draw the data.</p> 


<p>Don't be fooled by the richness and general purpose interface to the List 
Manager. The List Manager is not a spreadsheet.</p> 


<p><a href="#top">Back to top</a></p> 


<a name="Section5"></a> 
<h2>Dialog with the Devil</h2> 


<p>The Dialog Manager is very attractive. It looks like it will handle windows 
automatically with no programmer intervention, and can handle a wide variety of 
elements. It seems to handle controls, static text, editable text, and provides 

a way to display graphic elements as well. It must be the best possible world 
since the interface is very straightforward, and so much is done for the 

caller. At last, a superbly general purpose manager that can be used for any 
interface. Suddenly, reality rears its ugly head again, and it is interesting 

to note that this free lunch actually requires more work than doing the same 
job using the Window Manager, QuickDraw, TextEdit, and the Control Manager. 
Why? There is a hidden cost in terms of getting the Dialog Manager to do 
exactly the desired task. Here again, if the end result is supposed to be a 
simple dialog with a few controls, the Dialog Manager is suited to the job. 

That is what it was written to do. It was not designed as a way to handle the 
full interface for applications.</p> 


<p>As an example of a hidden cost, what if the interface requires that the 
program 

be able to handle a disk inserted event? If this is part of a 
<code>ModalDialog</code>, 

that requires passing a special <code>filterProc</code> to the dialog when it is 
called. 

It is now necessary to fully understand how the proc gets called, what is legal, 
and 

what the proc is required to do. That may not be too hard, but it is time spent on 
something that has nothing to do with getting the job done; it is only time spent 
understanding how the Dialog Manager works.</p> 


<p>Another example is adding something to a dialog which requires special 
setup 

and update routines. Here again, it is not too hard to figure out, but it is 

time spent trying to tell the Dialog Manager what should be done. There are 
literally hundreds of these special cases and tough, small problems when trying 


to extend a dialog past a simple interface. Hundreds of Mac programmers have 
wasted hundreds (thousands?) of hours finding ways to coerce the Dialog 
Manager 

into running a window in a special way.</p> 


<p>How about adding a special control to a dialog? Seems straightforward... 
How 

about making it modeless instead? How about moving some items in the dialog 
off 

screen? How about moving an EditText item off screen? How about wanting to 
change the dialog template before the dialog is used? How about all of the 
above all at the same time?</p> 


<p>How about skipping it and using the Window Manager instead?</p> 


<p>There are a number of performance penalties for large dialogs as well. A 
dialog 

with 50 radio buttons will be unacceptably slow. It should be noted that the 
Dialog Manager cannot know the desired purpose of the buttons, so it cannot set 
the button, nor clear another in the same set. In order to implement the actual 
radio button aspect of a set of controls, it has to be done by the calling 
program. At this point, the only thing the Dialog Manager is handling is the 
creation and drawing of the controls, which can easily be done with 
<code>GetNewControl</code> and <code>DrawControls</code>. The Dialog 
Manager actually 

gets in the way of a more complex interface. Looking into the data structures 
shows that the list of items in a dialog is a linear list. Also of note is that 

there are no offsets to the various items! This is significant because it means 
that the Dialog Manager has to drive through the entire list of items for every 
single operation it performs. If it gets an update event it has to traverse the 
list. If it gets a mouse event it has to traverse the list. This cannot be 

expected to be fast with 100 items.</p> 


<p>Another performance problem for some programmers is the simple drawing 
scheme 

used by the Dialog Manager. If a dialog has some items that are offscreen, they 
get drawn during update events anyway. The Dialog Manager will traverse the 
list and draw each item, whether it is on screen or not. This comes from the 
original design of the Dialog Manager, in that it was never intended to handle 
hundreds of items, or items off screen.</p> 


<p>Some rules of thumb: If there are more than 20 items in the dialog it should 
be 

a standard window. If a complicated control like a scroll bar is needed, it 

should be a standard window. If there are items offscreen, it should be a 
standard window. If there is a pictorial indicator like a progress indicator, 

it should be a standard window. If it is a modeless dialog it should be a 

standard window. If any of the items are movable in the dialog, it should be a 
standard window. If it is necessary to use a <code>filterProc</code> to add 
functionality, it should be a standard window. If in doubt, it should probably 

be a standard window.</p> 


<p>Handling a dialog with the Window Manager is very straightforward, much 
more so 


than trying to get around the Dialog Manager. There is the standard main event 
loop, 

and a conventional case statement to handle the events of interest. If there are 
controls 

in the window, they are easily handled with Control Manager calls. Any special 
items can 

be added to the case statement with no tricks. Overall there is more code to 
write, but 

the code is much less complex (read as: easier to figure out, easier to debug, 
easier 

to maintain). In addition, when extra items have to be added to the window, 
there is 

an easy-to-find, logical place to add the code. With the Dialog Manager there 
may 

be hidden difficulties.</p> 


<p>The Dialog Manager is very powerful, but to use the power it is necessary to 
use all sorts of hooks, procs, special items, and special calling sequences. As 
expected, only the interfaces to these things are described in <i>Inside 
Macintosh</i>. 

The sequence of events is the costly part. For an example of how to add a 
<code>userltem</code> to a dialog, 

examine <a href="../tb/tb_27.html">M.TB.DialogUserltems</a>. Note that it is 
not 

particularly simple to understand. Contrast that with the 
<code>FillRect/FrameRect</code> calls in the 

code that handles update events in a normal window.</p> 


<p>The Window Manager is more powerful than the Dialog Manager. The Dialog 
Manager 

uses the Window Manager. The Window Manager is much more straightforward 
to use since it follows 

the conventional Macintosh event model. That model is easier to understand and 
easier to extend. 

There are more calls to make, but the overall use is much simpler. There are 
very few special 

tricks needed to make any conceivable interface in a window.</p> 


<p>Don't be lured in by the "powerful" Dialog Manager calls, tricky hooks, and 
filter procedures. The Dialog Manager is not a user interface.</p> 
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<a name="Section1"></a> 
<h2>Introduction</h2> 


<p>Managers to avoid abusing, and the type of abuse:</p> 

<p>1) The Resource Manager is <b>not</b> a database.</p> 
<p>2) The TextEdit package is <b>not</b> a word processor.</p> 
<p>3) The List Manager is <b>not</b> a spreadsheet.</p> 


<p>4) The Dialog Manager is <b>not</b> a user interface.</p> 
<p><a href="#top">Back to top</a></p> 
<a name="Section2"></a><h2>No free database</h2> 


<p>After using the Resource Manager for a short time, its virtues become 
apparent: 

it is very flexible, it is easy to use, it gives disk based I/O with no extra calls, 
data can be extracted by either name or ID number, and the data is stored 
transparently 

so the caller can pretend the data is always available in a virtual memory 
fashion. 

With such wide ranging advantages, it would seem that the Resource Manager 
should 

be used for everything. It should be apparent that the TANSTAAFL (There Ain't 
No 

Such Thing As A Free Lunch) philosophy applies to the Resource Manager as well. 
If overextended, the Resource Manager will become slow and unusable.</p> 


<p>The Resource Manager is not a database, nor is it a good way to store user 
data. 

Although it can be used to store very small amounts of data, such as 
configuration data, 

and features some of the same characteristics of databases in general, the 
Resource Manager 

is a specialized tool designed specifically for the types of things that the 
Macintosh System needs. 

Its main virtue for system use is that a large variety of data can be stored on 
disk, and accessed 

when needed. This is a primitive form of virtual memory which extends the 
power of the system 


beyond what the RAM supplies. Remembering that the Resource Manager was 
written in an era of 

128K RAM, it should be apparent that it is optimized to use as little RAM as 
possible.</p> 


<p>The Resource Manager uses a simple data structure for accessing the data 
in the 

file. Examining the Resource Manager file format can show some of the tradeoffs 
expected. 

For instance, there is a linearly accessed table which describes all of the possible 
resource 

types that are in the current file. Without too much thought it should be apparent 
that if a 

file is created with thousands of different resource types then access to those 
resources 

will be slow. The reason? Each access requires scanning a linear array. There is 
no 

hashing technique used on the resource types.</p> 


<p>There is a similar linear table for the resource IDs themselves. Based on the 
previous discussion it should also be apparent that if there are thousands of 
resources of a specific type that the access time will become much larger. It 

will be imperceptible on a single access of a resource, but for thousands of 
accesses to the resource file the time spent traversing the linear list will 

impact the overall speed of the program. The user will not be pleased.</p> 


<p>Increasing the slowness by having too many resources as well as too many 
types 

will encourage the user to file the program in a ground based circular storage 
facility.</p> 


<p>As stated in<a href="../tb/tb_18.html">M.TB.MaxResInFile</a>, there is a 
limit of 

about 2700 resources in a given file due to the way the resources are stored. The 
performance penalty 

will arrive sooner, and the dividing line for where it is "too slow" is a personal 
preference. As a 

rule of thumb, if the program has the ability to store more than about 500 
resources total (both IDs 

and types), then consideration should be given to using the Data Fork instead. In 
particular, if 

the program allows the user to create data files, do not use the Resource 
Manager to store the 

user data. The users will always overextend the use of a program. Plan for it, and 
avoid 

making obviously bad decisions. For large amounts of data, the File Manager is 
the place 

to look. If the program wants to allow simultaneous (multi-user) access with read 
and 

write privileges to data files, then do not use the Resource Manager. Because it 
caches data, the Resource Manager cannot be relied upon as a multi-user 
database - even for small amounts of data. This is because there is no 

way to tell the Resource Manager its cache is invalid.</p> 


<p>Don't be fooled by a convenient interface. The Resource Manager is not a 
database, nor is it a file system.</p> 


<p><a href="#top">Back to top</a></p> 


<a name="Section3"></a> 
<h2>Words to live by</h2> 


<p>Looking at the TextEdit package can give the impression that there is a full 
featured word processing system built in. This is even more true now that 
TextEdit has 

been extended to support various styles and fonts. Unfortunately, appearances 
are deceiving, 

and TextEdit is not up to the job of being a word processor. Looking through the 
documentation 

shows that there is a 32,767 character limit on the text in a TextEdit record. The 
<code>teLength</code> is 

defined as an <code>Integer</code>. Another more subtle limit is the drawing 
limit of the rectangles 

surrounding the text. The <code>destRect</code> and 
<code>viewRect</code> both surround the complete 

TextEdit record. Using some rather rough approximations, there is an upper limit 
of about 

40 pages of text that can be supported in the QuickDraw rectangle. This is quite 
a lot 

for some applications, but is not very many when looking at the job typically 
required of a word processor. Users do not enjoy breaking their documents 

into multiple pieces.</p> 


<p>There are some other programmatic limitations, not the least of which is 
performance. TextEdit will become quite sluggish with large blocks of data. After 
2,000-4,000 

characters have been stored in a TextEdit record, the performance will have 
slowed to an unacceptable level. 

It is notable that the <code>lineStarts</code> array is a linear array of offsets 
into the edit record. If the 

data towards the end of the data record (high in the record) changes, the offsets 
have to be changed. 

This can involve updating thousands of <code>Integer</code> offsets for every 
character typed. If the 

different font, size and style information is tacked on top of all that, the 
performance can be 

expected to suffer with large blocks of text. Make no mistake about it, a full 
Macintosh style 

word processor is not an easy thing to write. TextEdit was not designed to handle 
large documents. It was designed as a simple field editor for the Dialog Manager, 
and extended from there. It was never intended to handle the large jobs 
expected 

of a word processor.</p> 


<p>In order to perform the operations required of a word processor it is 
necessary 

to use QuickDraw extensively. The expected Macintosh selection approach with 
autoscrolling, 


typing over selected text, cut/copy/paste, and so on are best implemented using 
QuickDraw directly. 

How the text is stored internally is the primary determining factor on how the 
word processor 

will perform.</p> 


<p>Don't be fooled by how easy it is to implement simple editing in an 
application. TextEdit is not a word processor.</p> 


<p><a href="#top">Back to top</a></p> 


<a name="Section4"></a> 
<h2>Checking lists twice</h2> 


<p>The List Manager appears to be a cell oriented display tool, allowing the 
easy 

creation of a spreadsheet interface using system calls. The rich interface to the 
manager 

makes it easy to handle arbitrary lists of data. Or does it? Although the List 
Manager is very 

flexible, easy to use, and general enough to handle graphic elements, its 
performance becomes 

unacceptable with relatively modest amounts of data. A one-dimensional list (like 
the files 

list in StdFile) can be done very well using the List Manager, but with several 
thousand 

items in the list, the performance may not be sufficient. This rarely happens in 
StdFile 

of course, and StdFile was the father of the List Manager. Here again, the tool 
was 

designed with a specific concept in mind, not to be the ultimate tool for handling 
any possible arbitrary data. A two-dimensional list of data will become too slow 
to use with an array as small as 10x100. This can hardly be expected to satisfy 
the user of a spreadsheet, since one "power" criteria is always the number 

of cells available.</p> 


<p>Why so slow? As above, examining the data structures used by the List 
Manager 

can tell a lot about the expected performance and limitations. Notably the 
<code>cellArray</code> 

used to offset to each cell's data is an old friend, a linear array of 
<code>Integer</code> offsets. 

It should come as no Surprise that inserting or deleting data from the middle of 
this array is slow. 

In order to do those functions the List Manager has to update the 
<code>Integer</code> offsets 

in the array each time. It has to step through each element on the linear array 
of offsets which will take some time on several thousand elements.</p> 


<p>The <code>maxindex</code> field of the ListRec is also notable since it is 
an 

<code>Integer</code> as well. The lists of data can be no more than 32K bytes 
in 

size, which could be somewhat limiting to a user.</p> 


<p>In addition, the List Manager is very general purpose, making it necessary 
for 

it to protect itself from bad data whenever possible. It needs to check the 
bounds of any rectangles it uses for example. It tries to minimize drawing out 
of bounds, so it checks each cell as it is drawn to be sure that it is on 

screen. Extra validity checks take some small, but finite, time. As the number 
of elements grows, the time adds up until it becomes a performance problem. 
Another limitation brought out by the data structure is the 
<code>listDefProc</code>, the list definition procedure. Since the List Manager 
is 

designed to be as general purpose as possible, it was necessary to add the 
ability to plug in a new defproc. This has ramifications for speed, however, 
since all drawing has to go through the bottleneck of the defproc. It won't 

cost much each time, but it will add up over a large number of cells.</p> 


<p>In order to get high performance out of this type of display, it is generally 
necessary to have as much precalculated as possible. This usually means having 
data structures which maintain themselves as much as possible, and which do 
not 

require changing anything outside of their single cell, thus avoiding impacting 
the entire display. Linear arrays don't come under this category, since any 
change impacts all the other cell data in the list. To create a high 
performance spreadsheet it is usually necessary to go to the QuickDraw level 
inside of a standard window. It is not typically necessary to be fully general 
for a specific type of data, so the performance can be improved merely by 
knowing the type of data expected. To handle large lists of data, the data 
should be stored in powerful data structures, and displayed with custom 
routines that know the best way to draw the data.</p> 


<p>Don't be fooled by the richness and general purpose interface to the List 
Manager. The List Manager is not a spreadsheet.</p> 


<p><a href="#top">Back to top</a></p> 


<a name="Section5"></a> 
<h2>Dialog with the Devil</h2> 


<p>The Dialog Manager is very attractive. It looks like it will handle windows 
automatically with no programmer intervention, and can handle a wide variety of 
elements. It seems to handle controls, static text, editable text, and provides 

a way to display graphic elements as well. It must be the best possible world 
since the interface is very straightforward, and so much is done for the 

caller. At last, a superbly general purpose manager that can be used for any 
interface. Suddenly, reality rears its ugly head again, and it is interesting 

to note that this free lunch actually requires more work than doing the same 
job using the Window Manager, QuickDraw, TextEdit, and the Control Manager. 
Why? There is a hidden cost in terms of getting the Dialog Manager to do 
exactly the desired task. Here again, if the end result is supposed to be a 
simple dialog with a few controls, the Dialog Manager is suited to the job. 

That is what it was written to do. It was not designed as a way to handle the 
full interface for applications.</p> 


<p>As an example of a hidden cost, what if the interface requires that the 
program 

be able to handle a disk inserted event? If this is part of a 
<code>ModalDialog</code>, 

that requires passing a special <code>filterProc</code> to the dialog when it is 
called. 

It is now necessary to fully understand how the proc gets called, what is legal, 
and 

what the proc is required to do. That may not be too hard, but it is time spent on 
something that has nothing to do with getting the job done; it is only time spent 
understanding how the Dialog Manager works.</p> 


<p>Another example is adding something to a dialog which requires special 
setup 

and update routines. Here again, it is not too hard to figure out, but it is 

time spent trying to tell the Dialog Manager what should be done. There are 
literally hundreds of these special cases and tough, small problems when trying 
to extend a dialog past a simple interface. Hundreds of Mac programmers have 
wasted hundreds (thousands?) of hours finding ways to coerce the Dialog 
Manager 

into running a window in a special way.</p> 


<p>How about adding a special control to a dialog? Seems straightforward... 
How 

about making it modeless instead? How about moving some items in the dialog 
off 

screen? How about moving an EditText item off screen? How about wanting to 
change the dialog template before the dialog is used? How about all of the 
above all at the same time?</p> 


<p>How about skipping it and using the Window Manager instead?</p> 


<p>There are a number of performance penalties for large dialogs as well. A 
dialog 

with 50 radio buttons will be unacceptably slow. It should be noted that the 
Dialog Manager cannot know the desired purpose of the buttons, so it cannot set 
the button, nor clear another in the same set. In order to implement the actual 
radio button aspect of a set of controls, it has to be done by the calling 
program. At this point, the only thing the Dialog Manager is handling is the 
creation and drawing of the controls, which can easily be done with 
<code>GetNewControl</code> and <code>DrawControls</code>. The Dialog 
Manager actually 

gets in the way of a more complex interface. Looking into the data structures 
shows that the list of items in a dialog is a linear list. Also of note is that 

there are no offsets to the various items! This is significant because it means 
that the Dialog Manager has to drive through the entire list of items for every 
single operation it performs. If it gets an update event it has to traverse the 
list. If it gets a mouse event it has to traverse the list. This cannot be 

expected to be fast with 100 items.</p> 


<p>Another performance problem for some programmers is the simple drawing 
scheme 

used by the Dialog Manager. If a dialog has some items that are offscreen, they 
get drawn during update events anyway. The Dialog Manager will traverse the 


list and draw each item, whether it is on screen or not. This comes from the 
original design of the Dialog Manager, in that it was never intended to handle 
hundreds of items, or items off screen.</p> 


<p>Some rules of thumb: If there are more than 20 items in the dialog it should 
be 

a standard window. If a complicated control like a scroll bar is needed, it 

should be a standard window. If there are items offscreen, it should be a 
standard window. If there is a pictorial indicator like a progress indicator, 

it should be a standard window. If it is a modeless dialog it should be a 

standard window. If any of the items are movable in the dialog, it should be a 
standard window. If it is necessary to use a <code>filterProc</code> to add 
functionality, it should be a standard window. If in doubt, it should probably 

be a standard window.</p> 


<p>Handling a dialog with the Window Manager is very straightforward, much 
more so 

than trying to get around the Dialog Manager. There is the standard main event 
loop, 

and a conventional case statement to handle the events of interest. If there are 
controls 

in the window, they are easily handled with Control Manager calls. Any special 
items can 

be added to the case statement with no tricks. Overall there is more code to 
write, but 

the code is much less complex (read as: easier to figure out, easier to debug, 
easier 

to maintain). In addition, when extra items have to be added to the window, 
there is 

an easy-to-find, logical place to add the code. With the Dialog Manager there 
may 

be hidden difficulties.</p> 


<p>The Dialog Manager is very powerful, but to use the power it is necessary to 
use all sorts of hooks, procs, special items, and special calling sequences. As 
expected, only the interfaces to these things are described in <i>Inside 
Macintosh</i>. 

The sequence of events is the costly part. For an example of how to add a 
<code>userltem</code> to a dialog, 

examine <a href="../tb/tb_27.html">M.TB.DialogUserltems</a>. Note that it is 
not 

particularly simple to understand. Contrast that with the 
<code>FillRect/FrameRect</code> calls in the 

code that handles update events in a normal window.</p> 


<p>The Window Manager is more powerful than the Dialog Manager. The Dialog 
Manager 

uses the Window Manager. The Window Manager is much more straightforward 
to use since it follows 

the conventional Macintosh event model. That model is easier to understand and 
easier to extend. 

There are more calls to make, but the overall use is much simpler. There are 
very few special 

tricks needed to make any conceivable interface in a window.</p> 


<p>Don't be lured in by the "powerful" Dialog Manager calls, tricky hooks, and 
filter procedures. The Dialog Manager is not a user interface.</p> 

<p><a href="#top">Back to top</a></p> 
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DontLinkElementID 26"= «span class="nodisclosure"» «/span» «span 
class="sectionName"><a 
href="/library/archive/samplecode/TextEdit/Listings/PrintingTextView_h.html#// 
apple_ref/doc/uid/DTS40011741-PrintingTextView_h- 

DontLinkElementID 26">PrintingTextView.h</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/DTS40011741-PrintingTextView_m- 
DontLinkElementID_27"><span class="nodisclosure"></span><span 
class="sectionName"><a 
href="/library/archive/samplecode/TextEdit/Listings/PrintingTextView_m.html#// 


apple_ref/doc/uid/DTS40011741-PrintingTextView_m- 
DontLinkElementID_27">PrintingTextView.m</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/DTS40011741-PrintPanelAccessoryController_h- 
DontLinkElementID 24"><span class="nodisclosure"></span><span 
class="sectionName"><a 
href="/library/archive/samplecode/TextEdit/Listings/PrintPanelAccessoryControlle 
r h.html£//apple ref/doc/uid/DTS40011741-PrintPanelAccessoryController h- 
DontLinkElementID_24">PrintPanelAccessoryController.h</a></span></li><li 
class=" " data-aref="//apple_ref/doc/uid/DTS40011741- 
PrintPanelAccessoryController m-DontLinkElementID 25"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/samplecode/TextEdit/Listings/PrintPanelAccessoryControlle 
r_m.html#//apple_ref/doc/uid/DTS40011741-PrintPanelAccessoryController_m- 
DontLinkElementID_25">PrintPanelAccessoryController.m</a></span></li><li 
class=" " data-aref="//apple_ref/doc/uid/DTS40011741-ScalingScrollView_h- 
DontLinkElementID_29"><span class="nodisclosure"></span><span 
class="sectionName"><a 
href="/library/archive/samplecode/TextEdit/Listings/ScalingScrollView_h.html#// 
apple_ref/doc/uid/DTS40011741-ScalingScrollView_h- 
DontLinkElementID_29">ScalingScrollView.h</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/DTS40011741-ScalingScrollView_m- 
DontLinkElementID_30"><span class="nodisclosure"></span><span 
class="sectionName"><a 
href="/library/archive/samplecode/TextEdit/Listings/ScalingScrollView_m.html#// 
apple_ref/doc/uid/DTS40011741-ScalingScrollView_m- 
DontLinkElementID_30">ScalingScrollView.m</a></span></li><li class=" " 
data-aref="//apple ref/doc/uid/DTS40011741-TextEditDefaultsKeys h- 
DontLinkElementID_31"><span class="nodisclosure"» «/span» «span 
class="sectionName"><a 
href="/library/archive/samplecode/TextEdit/Listings/TextEditDefaultsKeys_h.html 
#//apple_ref/doc/uid/DTS40011741-TextEditDefaultsKeys_h- 
DontLinkElementID_31">TextEditDefaultsKeys.h</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/DTS40011741-TextEditErrors_h- 
DontLinkElementID_32"><span class="nodisclosure"></span><span 
class="sectionName"><a 
href="/library/archive/samplecode/TextEdit/Listings/TextEditErrors h.html#// 
apple_ref/doc/uid/DTS40011741-TextEditErrors_h- 
DontLinkElementID_32">TextEditErrors.h</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/DTS40011741-TextEditMisc_h- 
DontLinkElementID_33"><span class="nodisclosure"></span><span 
class="sectionName"><a 
href="/library/archive/samplecode/TextEdit/Listings/TextEditMisc_h.html#// 
apple_ref/doc/uid/DTS40011741-TextEditMisc_h- 
DontLinkElementID_33">TextEditMisc.h</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/DTS40011741-RevisionHistory- 
DontLinkElementID 1"><span class="nodisclosure"></span><span 
class="sectionName"><a 
href="/library/archive/samplecode/TextEdit/History/History.html#//apple_ref/ 
doc/uid/DTS40011741-RevisionHistory-DontLinkElementID 1">Revision 
History</a></span></li></ul> 

</nav> 


<article id="contents" tabindex="0" role="main" class=""> 
<div id="pageNavigationLinks top" class="pageNavigationLinks"> 


<a class="nextLink" rel="next" href="../Listings/ReadMe_txt.html" 

onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
samplecode/TextEdit/Listings/ReadMe txt.html 1&quot;;return this.s oc? 
this.s oc(e):true">Next</a> 

</div> 

<a id="top" name="top"></a> 

<a id="INDEX" href="../index.html" style="display:none;" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
samplecode/TextEdit/index.html_1&quot;;return 
this.s_oc?this.s_oc(e):true"></a> 


<a name="//apple_ref/doc/uid/DTS40011741" title="TextEdit"></a><a 

name="//apple_ref/doc/uid/DTS40011741-Intro-DontLinkElementID_2" 
title="TextEdit"></a> 

«hl id="pageTitle"»TextEdit«/h15 «div class="spec sheet info box"><table 
cellspacing="0" class="specbox"><tbody><tr><td 
scope="row"><strong><span style="white-space: nowrap; ">Last 
Revision:</span></strong></td><td><div 
class="zSharedSpecBoxHeadList">Version 1.9, 2013-08-26<br>Updated for OS 
X v10.9 Mavericks.<br><span class="content_text"><a 
href="../History/History.html#//apple_ref/doc/uid/DTS40011741-RevisionHistory- 
DontLinkElementID 1" data-renderer-version="1" target=" self" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
samplecode/TextEdit/History/History.html#//apple_ref/_1&quot;;return this.s oc? 
this.s_oc(e):true">(Full Revision 
History)</a></span><br></div></td></tr> <tr><td 
scope="row"><strong><span style="white-space: nowrap;">Build 
Requirements:</span></strong></td><td><div 
class="zSharedSpecBoxHeadList">Xcode 5.0 or later, OS X v10.9 or 
later</div></td></tr><tr><td scope="row"><strong><span style="white- 
space: nowrap;">Runtime Requirements:</span></strong></td><td><div 
class="zSharedSpecBoxHeadList">OS X v10.9 or 
later.</div></td></tr></tbody></table></div> 

<div class="importantbox 
clear"><aside><p><strong>Important:</strong>&nbsp;This document is no 
longer being updated. For the latest information about Apple SDKs, visit the 
<span class="content_text"><a 
href="https://developer.apple.com/documentation" class="urlLink" 
rel="external" 
onclick="s_objectID=&quot;https://developer.apple.com/documentation_1&quot; 
¡return this.s oc?this.s oc(e):true">documentation 
website</a></span>.</p><p></p></aside></div> 


<p>This sample contains the source code for the TextEdit application. 
TextEdit is a simple text editor based on the text system in Cocoa.</p> 


«div id="pageNavigationLinks bottom" class="pageNavigationLinks"> 


<a class="nextLink" rel="next" href="../Listings/ReadMe_txt.html" 

onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
samplecode/TextEdit/Listings/ReadMe txt.html 2&quot;;return this.s oc? 
this.s oc(e):true">Next</a> 

</div><br> 

<div class="copyright"><br><hr><div align="center"><p 
class="content text" lang="en" dir="Itr'» Copyright © 2013 Apple Inc. All 
Rights Reserved. <a 
href="http://www.apple.com/legal/internet-services/terms/site.html" 
target="_blank" 
onclick="s_objectID=&quot;http://www.apple.com/legal/internet-services/terms/ 
site.html_1&quot;;return this.s oc?this.s oc(e):true">Terms of Use</a> | <a 
href="http://www.apple.com/privacy/" target="_blank" 
onclick="s_objectID=&quot;http://www.apple.com/privacy/_1&quot;;return 
this.s_oc?this.s_oc(e):true">Privacy Policy</a> | Updated: 
2013-08-26</p></div></div> 


<div id="pediaWindow"> 
<div id="pediaHeader"></div> 
<div id="pediaBody"></div> 
</div> 
</article> 


<div id="blackout"> 
<div id="preload"></div> 
</div> 
<div id="modal" aria-hidden="true"> 
<div id="closebox" tabindex="0" aria-label="Close feedback form" 
role="button"></div> 
<div id="sending" class="hidden"> 
<h2 tabindex="0">Sending feedback...</h2> 
<div id="sending img"></div> 
</div> 
<div id="error" class="hidden"> 
<h2 tabindex="0">We’re sorry, an error has occurred.</h2> 
<p>Please try submitting your feedback later.</p> 
<div id="error icon"></div> 
</div> 
<div id="success" class="hidden"> 
<h2 tabindex="0">Thank you for providing feedback!</h2> 
<p>Your input helps improve our developer documentation.</p> 
<div id="thank you icon"></div> 
</div> 


<form id="feedback" action="#" method="post"> 
<div class="left-leaf"> 
«h2 id="helpful title" data-asterisk="al" tabindex="0">How helpful is 
this document?</h2> 
<sup id="al" class="asterisk" aria-hidden="true">*</sup> 


<div id="star_group" role="radiogroup" aria-required="true"> 
<label> 
<input class="radio" type="radio" name="helped" value="1"> 
Very helpful 


</label> 
<label> 
<input class="radio" type="radio" name="helped" value="2"> 
Somewhat helpful 
</label> 
<label> 
<input class="radio" type="radio" name="helped" value="3"> 
Not helpful 
</label> 
</div> 
</div> 
<div class="right-leaf"> 
<h2>How can we improve this document?</h2> 
<div id="improve" class="checkboxes"> 
<label> 
<input type="checkbox" name="typo"> 
Fix typos or links 
</label> 
<label> 
<input type="checkbox" name="infolncorrect"> 
Fix incorrect information 
</label> 
<label> 
<input type="checkbox" name="needs examples"> 
Add or update code samples 
</label> 
<label> 
<input type="checkbox" name="needs_art"> 
Add or update illustrations 
</label> 
<label> 
<input type="checkbox" name="missinginfo"> 
Add information about... 
</label> 
</div> 
</div> 


<textarea id="comment" name="problem" cols="70" rows="8" 
placeholder="Please tell us more about your experience with this document" 
data-asterisk="a2" required=""></textarea> 

<sup id="a2" class="asterisk" aria-hidden="true">*</sup> 


<p class="fineprint"> 
<em aria-hidden="true"><span>*</span> Required information</em> 
</p> 


<input id="submit" type="button" value="Send"> 


<section id="legal"> 
<p> 
To submit a product bug or enhancement request, please visit the 
<a href="https://developer.apple.com/bugreporter/" target="_blank" 
onclick="s objectID=&quot;https://developer.apple.com/bugreporter/ 
_1&quot;;return this.s_oc?this.s_oc(e):true">Bug Reporter</a> 


page. 
</p> 
<p> 
Please read <a href="http://www.apple.com/legal/policies/ideas.html" 
target="_blank" 
onclick="s_objectID=&quot;http://www.apple.com/legal/policies/ideas.html_1&qu 
ot;;return this.s_oc?this.s_oc(e):true">Apple's Unsolicited Idea Submission 
Policy</a> 
before you send us your feedback. 
</p> 
</section> 
</form> 
</div> 


<script charset="utf-8" 
src="../../../Resources/1282/JavaScript/lib/prototype.js"></script> 
<script src="../../../Resources/1282/JavaScript/library.js"></script> 


</body></html><html lang="en"><head> 

<title>KeychainTouchlD: Using Touch ID with Keychain and 
LocalAuthentication</title> 

<meta http-equiv="X-UA-Compatible" content="IE=7"> 

<meta charset="utf-8"> 

<meta id="book-resource-type" name="book-resource-type" 
content="Sample Code"> 

<meta scheme="apple ref" id="identifier" name="identifier" 
content="//apple ref/doc/uid/TP40014530"> 

<meta id="document-version" name="document-version" content="3.1.0"> 

<meta id="build" name="build" 
content="c1e4c7a89af8f899a21cfa81fc33ba42"> 

<meta id="chapterld" name="chapterld" content="TP40014530-Intro"> 

<meta id="date" name="date" content="2018-06-04"> 

<meta id="description" name="description" content="Shows how to use 
Touch ID with keychain items and how to invoke Touch ID authentication."> 

<meta id="book-title" name="book-title" content="KeychainTouchlD: Using 
Touch ID with Keychain and LocalAuthentication"> 

<meta id="book-root" name="book-root" content="../"> 

<meta id="book-json" name="book-json" content="../book.json"> 

<meta id="devcenter" name="devcenter" content="Mac Dev Center"> 

<meta id="devcenter-url" name="devcenter-url" 
content="http://developer.apple.com/devcenter/mac"> 

<meta id="reflib" name="reflib" content="Documentation Archive"> 

<meta id="book-assignments" name="book-assignments" 
content="{Type/Sample Code}, {Technologies/Core OS 
Layer/LocalAuthentication}"> 


<meta name="ROBOTS" content="NOINDEX"> 

<meta id="copyright" name="copyright" content="Copyright 2018 Apple Inc. 
All Rights Reserved."> 

<meta id="xcode-display" name="xcode-display" content="render"> 


<meta id="IndexTitle" name="IndexTitle" content="KeychainTouchlD: Using 
Touch ID with Keychain and LocalAuthentication (Legacy): KeychainTouchlD: 
Using Touch ID with Keychain and LocalAuthentication"> 

<meta id="resources-uri" name="resources-uri" 
content="../../../Resources/1282"> 

<link id="book-index-page" rel="Start" title="KeychainTouchlD: Using Touch 
ID with Keychain and LocalAuthentication" type="text/html" 
href="../index.html"> 

<link id="next-page" rel="Next" type="text/html" 
href="../Listings/KeychainTouchID_main_m.html"> 

<link id="previous-page" rel="Prev" type="text/html" href=""> 

<link rel="stylesheet" type="text/css" 
href="../../../Resources/1282/CSS/screen.css"> 


<!-- xcode CSS --> 

<link rel="stylesheet" type="text/css" 
href="../../../Resources/1282/CSS/feedback.css"> 

<meta name="viewport" content="width=device-width, initial-scale=1, 
maximum-scale=1"> 

<meta id="platforms" name="platforms" content="iOS"> 

</head> 
<body class="" id=""><a name="//apple ref/doc/uid/TP40014530-Intro" 
title="KeychainTouchlD: Using Touch ID with Keychain and 
LocalAuthentication"></a> 

<div id=" omniture top"> 

<!-- SiteCatalyst code version: H.8. Copyright 1997-2006 Omniture, Inc. --> 

<script type="text/javascript"> 

/* RSID: */ 

var s account="appleglobal,appleusdeveloper,dappdeveloperlib" 

</script> 


<script type="text/javascript" 

src="https://www.apple.com/metrics/scripts/s_code_h.js"></script> 
<script type="text/javascript"> 
s.pageName=AC.Tracking.pageName(); 
s.channel="www.us.developer" 


porppopopoprrx DO NOT ALTER ANYTHING BELOW THIS LINE | eee 
var s code=s.t();if(s_code)document.write(s_code)</script> 

<!-- End SiteCatalyst code version: H.8. --> 

</div> 


<div id="adcHeader" class="hideOnPrint hidelnxcode"> 
<div id="ssi_Header" class="hidelnXcode unified"> 

<a id="ssi_LibraryTitle" 
href="https://developer.apple.com/library/archive/navigation/" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
navigation/_1&quot;;return this.s_oc?this.s_oc(e):true">Documentation 
Archive</a> 

<a id="ssi_AppleDeveloperConnection" 
href="https://developer.apple.com/" 
onclick="s_objectID=&quot;https://developer.apple.com/_1&quot;;return 
this.s_oc?this.s_oc(e):true">Developer</a> 

<div id="ssi SearchButton" role="button" title="Search">Search</div> 


</div> 
<form id="ssi_SearchMenu" method="get" action="../../../search/" accept- 
charset="utf-8"> 
<label for="adcsearch">Search Documentation Archive</label> 


<input type="search" id="ssi_SearchField" name="q" accesskey="s" 
results="5"> 
</form> 
</div> 


<header id="header"> 
<div id="title" role="banner"> 
<h1>KeychainTouchID: Using Touch ID with Keychain and 
LocalAuthentication</h1> 
<span id="file_links"> 
<a id="PDF_link" role="button" tabindex="4" rel="alternate" 
title="Download PDF" class=""><span id="pdf_icon"></span>PDF</a> 
<a id="Companion link" role="button" tabindex="3" title="Download 
Companion File" class=""><span id="companion_icon"></span>Companion 
File</a> 
</span> 
</div> 
<ul id="headerButtons" class="hideOnPrint" role="toolbar"> 
<li id="toc_button" style=""> 
<button tabindex="5" id="table of contents" class="" 
role="checkbox" aria-label="Show Table of Contents"><span 
class="disclosure"></span>Table of Contents</button> 
</li> 
<li id="jumpto_button" style="display:none" role="navigation"><select 
tabindex="6" id="jumpTo"><option value="top">Jump 
To...</option></select></li> 
«li id="downloadSample button" style=""> 
«a id="Sample link" 
href="/library/archive/samplecode/KeychainTouchID/KeychainTouchIDUsingTouc 
hIDwithKeychainandLocalAuthentication.zip"><button 
id="Sample_button">Download Sample Code</button></a> 
</li> 
</ul> 
</header> 
<nav id="tocContainer" tabindex="7" class=""> 
«ul id="toc" role="tree"><li class=" " 
data-aref="//apple_ref/doc/uid/TP40014530-Intro-DontLinkElementID_2"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/samplecode/KeychainTouchID/Introduction/Intro.html#// 
apple ref/doc/uid/TP40014530-Intro-DontLinkElementID 2">About 
KeychainTouchlD: Using Touch ID with Keychain and 
LocalAuthentication</a></span></li><li class=" " 
data-aref="//apple ref/doc/uid/TP40014530-KeychainTouchID main m- 
DontLinkElementID 14"><span class="nodisclosure"></span><span 
class="sectionName"><a 
href="/library/archive/samplecode/KeychainTouchID/Listings/KeychainTouchID m 
ain m.html£//apple ref/doc/uid/TP40014530-KeychainTouchID main m- 


DontLinkElementID 14">KeychainTouchID/main.m</a></span></li><li class=" 
" data-aref="//apple ref/doc/uid/TP40014530-KeychainTouchID AAPLTest m- 
DontLinkElementID 13"><span class="nodisclosure"></span><span 
class="sectionName"><a 
href="/library/archive/samplecode/KeychainTouchID/Listings/KeychainTouchID A 
APLTest_m.html#//apple_ref/doc/uid/TP40014530-KeychainTouchID_AAPLTest_m- 
DontLinkElementID_13">KeychainTouchID/AAPLTest.m</a></span></li><li 
class=" " data-aref="//apple_ref/doc/uid/TP40014530- 

KeychainTouchID AAPLAppDelegate m-DontLinkElementID 5"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/samplecode/KeychainTouchID/Listings/KeychainTouchID A 
APLAppDelegate_m.html#//apple_ref/doc/uid/TP40014530- 
KeychainTouchID_AAPLAppDelegate_m- 
DontLinkElementID_5">KeychainTouchID/AAPLAppDelegate.m</a></span></ 
li><li class=" " data-aref="//apple ref/doc/uid/TP40014530- 

KeychainTouchID AAPLBasicTestViewController h-DontLinkElementID 6"» «span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/samplecode/KeychainTouchID/Listings/KeychainTouchID A 
APLBasicTestViewController_h.html#//apple_ref/doc/uid/TP40014530- 
KeychainTouchID AAPLBasicTestViewController h- 

DontLinkElementID 6">KeychainTouchID/AAPLBasicTestViewController.h</ 
a></span></li><li class=" " data-aref="//apple ref/doc/uid/TP40014530- 
KeychainTouchID AAPLBasicTestViewController m-DontLinkElementID 7"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/samplecode/KeychainTouchID/Listings/KeychainTouchID A 
APLBasicTestViewController_m.html#//apple_ref/doc/uid/TP40014530- 
KeychainTouchID AAPLBasicTestViewController m- 

DontLinkElementID 7">KeychainTouchID/AAPLBasicTestViewController.m</ 
a></span></li><li class=" " data-aref="//apple ref/doc/uid/TP40014530- 
KeychainTouchID AAPLKeychainTestsViewController m- 
DontLinkElementID_9"><span class="nodisclosure"» «/span» «span 
class="sectionName"><a 
href="/library/archive/samplecode/KeychainTouchID/Listings/KeychainTouchID A 
APLKeychainTestsViewController m.html#//apple ref/doc/uid/TP40014530- 
KeychainTouchID AAPLKeychainTestsViewController m- 

DontLinkElementID 9">KeychainTouchID/ 
AAPLKeychainTestsViewController.m</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40014530- 

KeychainTouchID AAPLLocalAuthenticationTestsViewController h- 
DontLinkElementID_10"><span class="nodisclosure"></span><span 
class="sectionName"><a 
href="/library/archive/samplecode/KeychainTouchID/Listings/KeychainTouchID A 
APLLocalAuthenticationTestsViewController h.html#//apple ref/doc/uid/ 
TP40014530-KeychainTouchID AAPLLocalAuthenticationTestsViewController h- 
DontLinkElementID 10">KeychainTouchID/ 
AAPLLocalAuthenticationTestsViewController.h</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40014530- 

KeychainTouchID AAPLLocalAuthenticationTestsViewController m- 
DontLinkElementID 11"><span class="nodisclosure"></span><span 
class="sectionName"><a 
href="/library/archive/samplecode/KeychainTouchID/Listings/KeychainTouchID A 
APLLocalAuthenticationTestsViewController_m.html#//apple_ref/doc/uid/ 
TP40014530-KeychainTouchID_AAPLLocalAuthenticationTestsViewController_m- 
DontLinkElementID 11">KeychainTouchID/ 


AAPLLocalAuthenticationTestsViewController.m</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40014530- 
KeychainTouchID_AAPLKeychainTestsViewController_h- 
DontLinkElementID 8"><span class="nodisclosure"></span><span 
class="sectionName"><a 
href="/library/archive/samplecode/KeychainTouchID/Listings/KeychainTouchID A 
APLKeychainTestsViewController_h.html#//apple_ref/doc/uid/TP40014530- 
KeychainTouchID_AAPLKeychainTestsViewController_h- 
DontLinkElementID 8">KeychainTouchID/AAPLKeychainTestsViewController.h</ 
a></span></li><li class=" " data-aref="//apple ref/doc/uid/TP40014530- 
KeychainTouchID AAPLTest h-DontLinkElementID 12"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/samplecode/KeychainTouchID/Listings/KeychainTouchID A 
APLTest_h.html#//apple_ref/doc/uid/TP40014530-KeychainTouchID_AAPLTest_h- 
DontLinkElementID 12">KeychainTouchID/AAPLTest.h</a></span></li><li 
class=" " data-aref="//apple ref/doc/uid/TP40014530- 
KeychainTouchID AAPLAppDelegate h-DontLinkElementID 4"><span 
class="nodisclosure"></span><span class="sectionName"><a 
href="/library/archive/samplecode/KeychainTouchID/Listings/KeychainTouchID A 
APLAppDelegate_h.html#//apple_ref/doc/uid/TP40014530- 
KeychainTouchID AAPLAppDelegate h-DontLinkElementID 4">KeychainTouchID/ 
AAPLAppDelegate.h</a></span></li><li class=" " 
data-aref="//apple_ref/doc/uid/TP40014530-README md- 
DontLinkElementID_16"><span class="nodisclosure"></span><span 
class="sectionName"><a 
href="/library/archive/samplecode/KeychainTouchID/Listings/README_md.html#/ 
/apple_ref/doc/uid/TP40014530-README md- 
DontLinkElementID_16">README.md</a></span></li><li class=" " data- 
aref="//apple_ref/doc/uid/TP40014530-LICENSE_txt- 
DontLinkElementID_15"><span class="nodisclosure"></span><span 
class="sectionName"><a 
href="/library/archive/samplecode/KeychainTouchID/Listings/LICENSE txt.html#// 
apple ref/doc/uid/TP40014530-LICENSE txt- 
DontLinkElementID_15">LICENSE.txt</a></span></li><li class=" " data- 
aref="//apple ref/doc/uid/TP40014530-RevisionHistory- 
DontLinkElementID 1"><span class="nodisclosure"></span><span 
class="sectionName"><a 
href="/library/archive/samplecode/KeychainTouchID/History/History.html#// 
apple ref/doc/uid/TP40014530-RevisionHistory-DontLinkElementID 1">Revision 
History</a></span></li></ul> 
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<a name="//apple ref/doc/uid/TP40009542" title="About Text Handling in 
iOS"></a><a name="//apple_ref/doc/uid/TP40009542-CH1-SW1" title="About 
Text Handling in iOS"></a><h1 id="pageTitle">About Text Handling in 
¡OS</h1><a name="//apple_ref/doc/uid/TP40009542-CH1- 
DontLinkElementID_1"></a><p>The iOS platform gives you many ways to 
display text in your apps and let users edit that text. It also lets you display 
formatted text and web content in your app’s views. The resources at your 
disposal range from <span class="pediaLink" data-header="Framework" data- 
contents="A framework is a bundle (a structured directory) that contains a 
dynamic shared library along with associated resources, such as nib files, image 
files, and header files. "><a data-renderer-version="1" target="_self" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
documentation/General/Conceptual/DevPedia-CocoaCore/F_1&quot;;return 
this.s oc?this.s oc(e):true" data-href="../../../../General/Conceptual/DevPedia- 
CocoaCore/Framework.html#//apple_ref/doc/uid/TP40008195- 
CH56">framework</a></span> objects—such as text views, text fields, and 
web views—to text layout engines that you can use directly to draw, lay out, and 
otherwise manage text.</p><figure class="figure"><img 
src="../Art/textpg intro 2x.png" alt="../Art/textpg_intro_2x.png" width="657" 
height="340"></figure><p>With the classes in the UIKit framework, you can 
manage the edit menu (including adding custom items to it), implement custom 
input views, and copy, cut, and paste data within and between apps.«/p= «div 


class="notebox"><aside><a name="//apple_ref/doc/uid/TP40009542-CH1-SW2" 
title="Note"></a><p><strong>Note:</strong>&nbsp;This document was 
previously titled <em>Text, Web, and Editing Programming Guide for 
¡OS</em>.</p><p></p></aside></div><a 
name="//apple_ref/doc/uid/TP40009542-CH1-SW3" title="At a 
Glance"></a><h2 class="jump">At a Glance</h2><p>Apps in iOS have a 
number of powerful technologies to handle text, both for editing text and for 
rendering high-quality typographically formatted text.</p><section><a 
name="//apple_ref/doc/uid/TP40009542-CH1-SW4" title="The UIKit Framework 
Provides Your App with Text and Web Objects"></a><h3>The UIKit Framework 
Provides Your App with Text and Web Objects</h3><p>You can add ready- 
made text views, text fields, and labels to your app’s user interface by using 
instances of the <code><a 
href="https://developer.apple.com/documentation/uikit/uitextview" 
class="urlLink" target="_self" 
onclick="s_objectID=&quot;https://developer.apple.com/documentation/uikit/ 
uitextview_1&quot;;return this.s oc?this.s oc(e):true">UlTextView</a></code>, 
<code><a href="https://developer.apple.com/documentation/uikit/uitextfield" 
class="urlLink" target=" self" 
onclick="s_objectID=&quot;https://developer.apple.com/documentation/uikit/ 
uitextfield_1&quot;;return this.s oc?this.s oc(e):true">UlTextField</a></code>, 
and <code><a href="https://developer.apple.com/documentation/uikit/uilabel" 
class="urlLink" target=" self" 
onclick="s_objectID=&quot;https://developer.apple.com/documentation/uikit/ 
uilabel 1&quot;;return this.s_oc?this.s_oc(e):true">UlLabel</a></code>. You 
can add and configure them programmatically or by using the <span 
class="pediaLink" data-header="Nib file" data-contents="A nib file is a special 
type of resource file that you use to store the user interfaces of iOS and Mac 
apps. "><a data-renderer-version="1" target="_self" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
documentation/General/Conceptual/DevPedia-CocoaCore/N_1&quot;;return 
this.s oc?this.s oc(e):true" data-href="../../../../General/Conceptual/DevPedia- 
CocoaCore/NibFile.html#//apple ref/doc/uid/TP40008195-CH34">Interface 
Builder</a></span> editor in Xcode. You can also turn a view of your app into a 
miniature web browser capable of understanding and displaying HTML, CSS, and 
JavaScript content.</p><div class="notebox"><aside><a 
name="//apple_ref/doc/uid/TP40009542-CH1-SW5" title="Relevant 
Chapters"></a><p><strong>Relevant Chapters:</strong>&nbsp;<span 
class="content_text"><a 
href="../UsingTextClasses/UsingTextClasses.html#//apple_ref/doc/uid/ 
TP40009542-CH2-SW1" data-renderer-version="1" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
documentation/StringsTextFonts/Conceptual/TextAndWebi 3&quot;;return 
this.s_oc?this.s_oc(e):true">Displaying Text Content in iOS</a></span>, <span 
class="content_text"><a 
href="../TypoFeatures/TextSystemFeatures.html#//apple_ref/doc/uid/ 
TP40009542-CH6-BBCFAEGE" data-renderer-version="1" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
documentation/StringsTextFonts/Conceptual/TextAndWebi_4&quot;;return 
this.s_oc?this.s_oc(e):true">Typographical Concepts</a></span>, <span 
class="content_text"><a 
href="../ManageTextFieldTextViews/ManageTextFieldTextViews.html#// 
apple_ref/doc/uid/TP40009542-CH10-SW1" data-renderer-version="1" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 


documentation/StringsTextFonts/Conceptual/TextAndWebi 5&quot;;return 

this.s oc?this.s oc(e):true">Managing Text Fields and Text 
Views</a></span></p><p></p></aside></div></section><section><a 
name="//apple_ref/doc/uid/TP40009542-CH1-SW6" title="When Users Edit Text, 
Your App Must Manage the Keyboard"></a><h3>When Users Edit Text, Your 
App Must Manage the Keyboard</h3><p>When a user taps a text field, text 
view, or form field in a web view, iOS animates a keyboard into view. An app can 
control which keyboard is presented; for example, for a numeric-value field, the 
app should select the numeric keypad. If the entered or edited text is obscured 
by the keyboard, the app should adjust the view displaying the text so that the 
text appears above the keyboard. The <span class="pediaLink" data- 
header="Delegation" data-contents="Delegation is a simple and powerful 
pattern in which one object in a program acts on behalf of, or in coordination 
with, another object. "><a data-renderer-version="1" target="_self" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
documentation/General/Conceptual/DevPedia-CocoaCore/D_1&quot;;return 
this.s oc?this.s oc(e):true" data-href="../../../../General/Conceptual/DevPedia- 
CocoaCore/Delegation.html£//apple ref/doc/uid/TP40008195- 
CH14">delegate</a></span> of a text view, text field, or web view is 
responsible for validating edited text and for accessing and storing edited text 
when the user dismisses the keyboard. </p><div class="notebox"><aside><a 
name="//apple_ref/doc/uid/TP40009542-CH1-SW7" title="Relevant 
Chapters"></a><p><strong>Relevant Chapters:</strong>&nbsp;<span 
class="content_text"><a 
href="../KeyboardManagement/KeyboardManagement.html#//apple_ref/doc/ 
uid/TP40009542-CH5-SW1" data-renderer-version="1" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
documentation/StringsTextFonts/Conceptual/TextAndWebi 6&quot;;return 

this.s oc?this.s oc(e):true">Managing the 
Keyboard</a></span></p><p></p></aside></div></section><section><a 
name="//apple_ref/doc/uid/TP40009542-CH1-SW8" title="Your App Can Draw 
and Manage Text Directly"></a><h3>Your App Can Draw and Manage Text 
Directly</h3><p>Underlying the text views in UIKit is a powerful layout engine 
called Text Kit. If you need to customize the layout process or you need to 
intervene in that behavior, you can use Text Kit. Text Kit is a set of classes and 
protocols that provide high-quality typographical services which enable apps to 
store, lay out, and display text with allthe characteristics of fine typesetting, 
such as kerning, ligatures, line breaking, and justification.</p><p>For most 
apps, you can use the high-level text display classes and Text Kit for all their text 
handling. For smaller amounts of text and special needs requiring custom 
solutions, you can use alternate, lower level technologies, such as the 
programmatic interfaces from the Core Text, Core Graphics, and Core Animation 
frameworks as well as other APIs in UIKit itself. </p><p>To communicate directly 
with the text-input system of iOS, implement the <code><a 
href="https://developer.apple.com/documentation/uikit/uitextinput" 
class="urlLink" target="_self" 
onclick="s_objectID=&quot;https://developer.apple.com/documentation/uikit/ 
uitextinput_1&quot;;return this.s oc?this.s oc(e):true">UITextinput</a></code> 
<span class="pediaLink" data-header="Protocol" data-contents="A protocol 
declares a programmatic interface that any class may choose to implement. 
"><a data-renderer-version="1" target=" self" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
documentation/General/Conceptual/DevPedia-CocoaCore/P_1&quot;;return 
this.s_oc?this.s_oc(e):true" data-href="../../../../General/Conceptual/DevPedia- 


CocoaCore/Protocol.html#//apple_ref/doc/uid/TP40008195-CH45">protocol</ 
a></span> and related protocols and classes. Your app can also make use of 
technologies for spell checking and regular expressions.</p><div 
class="notebox"><aside><a name="//apple_ref/doc/uid/TP40009542-CH1-SW9" 
title="Relevant Chapter"></a><p><strong>Relevant 

Chapter: </strong>&nbsp;<span class="content text"><a 
href="../CustomTextProcessing/CustomTextProcessing.html#//apple_ref/doc/ 
uid/TP40009542-CH4-SW1" data-renderer-version="1" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
documentation/StringsTextFonts/Conceptual/TextAndWebi 7&quot;;return 
this.s oc?this.s oc(e):true">Using Text Kit to Draw and Manage 
Text</a></span>, <span class="content text"><a href="../LowerLevelText- 
HandlingTechnologies/LowerLevelText-HandlingTechnologies.html#//apple_ref/ 
doc/uid/TP40009542-CH15-SW1" data-renderer-version="1" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
documentation/StringsTextFonts/Conceptual/TextAndWebi_8&quot;;return 
this.s_oc?this.s_oc(e):true">Lower Level Text-Handling 
Technologies</a></span></p><p></p></aside></div></section><section> 
<a name="//apple_ref/doc/uid/TP40009542-CH1-SW11" title="Your App Has a 
Range of Options for the Input and Editing of Data"></a><h3>Your App Has a 
Range of Options for the Input and Editing of Data</h3><p>The UIKit 
framework includes programmatic interfaces for editing the data in a view and 
for entering data into an app. Custom input views can replace the system 
keyboard to permit input of special data; input accessory views are a custom 
view above the system keyboard (or custom input view) that enables users to 
affect edited data in app-specific ways. Using <code><a 
href="https://developer.apple.com/documentation/uikit/uipasteboard" 
class="urlLink" target="_self" 
onclick="s_objectID=&quot;https://developer.apple.com/documentation/uikit/ 
uipasteboard_1&quot;;return 

this.s oc?this.s oc(e):true">UlPasteboard</a></code> and related classes, an 
app can copy, cut, and paste data within different locations of itself or between 
itself and another app. As part of copy-cut-paste operations, the user taps a 
command on an contextual edit menu; your app manages this menu and can 
add custom commands to it.</p><div class="notebox"><aside><a 
name="//apple_ref/doc/uid/TP40009542-CH1-SW12" title="Relevant 
Chapters:"></a><p><strong>Relevant Chapters::</strong>&nbsp;<span 
class="content_text"><a 
href="../UsingCopy,Cut,andPasteOperations/UsingCopy,Cut,andPasteOperations. 
html#//apple_ref/doc/uid/TP40009542-CH11-SW1" data-renderer-version="1" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
documentation/StringsTextFonts/Conceptual/TextAndWebi 9&quot;;return 
this.s oc?this.s oc(e):true">Copy, Cut, and Paste Operations</a></span>, 
<span class="content text"><a 
href="../AddingCustomEditMenultems/AddingCustomEditMenultems.html#// 
apple_ref/doc/uid/TP40009542-CH13-SW1" data-renderer-version="1" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
documentation/StringsTextFonts/Conceptual/TextAndWebi 10&quot;;return 
this.s oc?this.s oc(e):true">Displaying and Managing the Edit 
Menu</a></span>, <span class="content text"><a 
href="../InputViews/InputViews.html#//apple_ref/doc/uid/TP40009542-CH12- 
SWL" data-renderer-version="1" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
documentation/StringsTextFonts/Conceptual/TextAndWebi 11&quot;;return 


this.s_oc?this.s_oc(e):true">Custom Views for Data 
Input</a></span></p><p></p></aside></div></section><div 
id="introSeeAlsoSection"><a name="//apple_ref/doc/uid/TP40009542-CH1- 
SW10" title="See Also"></a><h2 class="jump">See Also</h2><p>The Core 
Graphics and Core Animation frameworks have some text-handling capabilities. 
Core Animation, for example, offers the <code><a 
href="https://developer.apple.com/documentation/quartzcore/catextlayer" 
class="urlLink" target="_self" 
onclick="s_objectID=&quot;https://developer.apple.com/documentation/ 
quartzcore/catextlayer 1&quot;;return this.s oc? 
this.s oc(e):true">CATextLayer</a></code> class. To learn more about these 
capabilities, read <em><a 
href="../../../../Graphicslmaging/Conceptual/drawingwithquartz2d/Introduction/ 
Introduction.html#//apple_ref/doc/uid/TP30001066" data-renderer-version= "l" 
target=" self" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
documentation/Graphicsimaging/Conceptual/drawingwithq_18quot;;return 
this.s oc?this.s oc(e):true">Quartz 2D Programming Guide</a></em> (Core 
Graphics) and <em><a 
href="../../../../Cocoa/Conceptual/CoreAnimation_guide/Introduction/ 
Introduction.html#//apple_ref/doc/uid/TP40004514" data-renderer-version="1" 
target="_self" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
documentation/Cocoa/Conceptual/CoreAnimation_guide/In_1&quot;;return 
this.s_oc?this.s_oc(e):true">Core Animation Programming Guide</a></em>. 
</p><p>To find out more about the Core Text framework, which is appropriate 
for developing higher-level text-handling frameworks, read <em><a 
href="../../CoreText_Programming/Introduction/Introduction.html#//apple_ref/ 
doc/uid/TP40005533" data-renderer-version="1" target="_self" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
documentation/StringsTextFonts/Conceptual/CoreText Pr 1&quot;;return 
this.s oc?this.s oc(e):true">Core Text Programming Guide</a></em> and 
<em><a href="https://developer.apple.com/documentation/coretext" 
class="urlLink" target=" self" 
onclick="s_objectID=&quot;https://developer.apple.com/documentation/ 
coretext_1&quot;;return this.s_oc?this.s_oc(e):true">Core Text Reference 
Collection</a></em>.</p></div> 

<div id="pageNavigationLinks bottom" class="pageNavigationLinks"> 

<a class="nextLink" rel="next" 

href="../UsingTextClasses/UsingTextClasses.html" 
onclick="s_objectID=é:quot;https://developer.apple.com/library/archive/ 
documentation/StringsTextFonts/Conceptual/TextAndWebi_12&quot;;return 
this.s_oc?this.s_oc(e):true">Next</a> 

</div><br> 

<div class="copyright"><br><hr><div align="center"><p 
class="content text" lang="en" dir="Itr'» Copyright © 2018 Apple Inc. All 
Rights Reserved. <a 
href="http://www.apple.com/legal/internet-services/terms/site.html" 
target="_blank" 
onclick="s_objectID=&quot;http://www.apple.com/legal/internet-services/terms/ 
site.html_1&quot;;return this.s oc?this.s oc(e):true">Terms of Use</a> | <a 
href="http://www.apple.com/privacy/" target="_blank" 
onclick="s_objectID=&quot;http://www.apple.com/privacy/_1&quot;;return 


this.s_oc?this.s_oc(e):true">Privacy Policy</a> | Updated: 
2018-01-16</p></div></div> 


<div id="pediaWindow"> 
<div id="pediaHeader"></div> 
<div id="pediaBody"></div> 
</div> 
</article> 


<div id="blackout"> 
<div id="preload"></div> 
</div> 
<div id="modal" aria-hidden="true"> 
<div id="closebox" tabindex="0" aria-label="Close feedback form" 
role="button"></div> 
<div id="sending" class="hidden"> 
<h2 tabindex="0">Sending feedback...</h2> 
<div id="sending img"></div> 
</div> 
<div id="error" class="hidden"> 
<h2 tabindex="0">We’re sorry, an error has occurred.</h2> 
<p>Please try submitting your feedback later.</p> 
<div id="error icon"></div> 
</div> 
<div id="success" class="hidden"> 
<h2 tabindex="0">Thank you for providing feedback!</h2> 
<p>Your input helps improve our developer documentation.</p> 
<div id="thank you icon"></div> 
</div> 


<form id="feedback" action="#" method="post"> 
<div class="left-leaf"> 
<h2 id="helpful title" data-asterisk="al" tabindex="0">How helpful is 
this document?</h2> 
<sup id="al" class="asterisk" aria-hidden="true">*</sup> 


<div id="star_group" role="radiogroup" aria-required="true"> 
<label> 
<input class="radio" type="radio" name="helped" value="1"> 
Very helpful 
</label> 
<label> 
<input class="radio" type="radio" name="helped" value="2"> 
Somewhat helpful 
</label> 
<label> 
<input class="radio" type="radio" name="helped" value="3"> 
Not helpful 
</label> 
</div> 
</div> 
<div class="right-leaf"> 
<h2>How can we improve this document?</h2> 
<div id="improve" class="checkboxes"> 


<label> 
<input type="checkbox" name="typo"> 
Fix typos or links 

</label> 

<label> 
<input type="checkbox" name="infolncorrect"> 
Fix incorrect information 

</label> 

<label> 
<input type="checkbox" name="needs examples"> 
Add or update code samples 

</label> 

<label> 
<input type="checkbox" name="needs art"> 
Add or update illustrations 

</label> 

<label> 
<input type="checkbox" name="missinginfo"> 
Add information about... 

</label> 

</div> 
</div> 


<textarea id="comment" name="problem" cols="70" rows="8" 
placeholder="Please tell us more about your experience with this document" 
data-asterisk="a2" required=""></textarea> 

<sup id="a2" class="asterisk" aria-hidden="true">*</sup> 


<p class="fineprint"> 
<em aria-hidden="true"><span>*</span> Required information</em> 
</p> 


<input id="submit" type="button" value="Send"> 


<section id="legal"> 
<p> 
To submit a product bug or enhancement request, please visit the 
<a href="https://developer.apple.com/bugreporter/" target="_blank" 
onclick="s_objectID=&quot;https://developer.apple.com/bugreporter/ 
_1&quot;;return this.s_oc?this.s_oc(e):true">Bug Reporter</a> 
page. 
</p> 
<p> 
Please read <a href="http://www.apple.com/legal/policies/ideas.html" 
target="_blank" 
onclick="s_objectID=&quot;http://www.apple.com/legal/policies/ideas.html_1&qu 
ot;;return this.s_oc?this.s_oc(e):true">Apple's Unsolicited Idea Submission 
Policy</a> 
before you send us your feedback. 
</p> 
</section> 
</form> 
</div> 


<script charset="utf-8" 
src="../../../../../Resources/1282/JavaScript/lib/prototype.js" ></script> 
<script src="../../../../../Resources/1282/JavaScript/library.js"></script> 


</body></html><html lang="en"><head> 
<meta name="ROBOTS" content="NOINDEX, NOFOLLOW"> 

<title>Technical Note TN2127: Kernel Authorization</title> 

<meta http-equiv="X-UA-Compatible" content="IE=7"> 

<meta charset="utf-8"> 

<meta id="book-resource-type" name="book-resource-type" 
content="Technical Note"> 

<meta scheme="apple_ref" id="identifier" name="identifier" 
content="//apple_ref/doc/uid/DTS10003591"> 

<meta id="document-version" name="document-version" content="1.2.0"> 

<meta id="build" name="build" 
content="cle4c7a89af8f899a21cfa81fc33ba42"» 

«meta id="chapterld" name="chapterld" content="DTS10003591-CH1"> 

<meta id="date" name="date" content="2010-03-23"> 

<meta id="description" name="description" content="TN2127: Describes the 
kernel authorization (kauth) subsystem and its associated KPI."> 

<meta id="book-title" name="book-title" content="Kernel Authorization"> 

<meta id="book-root" name="book-root" content="./"> 

<meta id="book-json" name="book-json" content="book.json"> 

<meta id="devcenter" name="devcenter" content="Mac Dev Center"> 

<meta id="devcenter-url" name="devcenter-url" 
content="http://developer.apple.com/devcenter/mac"> 

<meta id="reflib" name="reflib" content="Documentation Archive"> 

<meta id="book-assignments" name="book-assignments" 
content="{Type/Technical Note}, {Technologies/Kernel &amp; Driver 
Layer/Kernel}, {Topic/Drivers, Kernel, &amp; Hardware/General Kernel 
Extensions}"> 


<meta id="copyright" name="copyright" content="Copyright 2018 Apple Inc. 
All Rights Reserved."> 

<meta id="xcode-display" name="xcode-display" content="render"> 

<meta id="IndexTitle" name="IndexTitle" content="Technical Note TN2127"> 

<meta id="resources-uri" name="resources-uri" 
content="../../Resources/1282"> 

<link id="book-index-page" rel="Start" title="Kernel Authorization" 
type="text/html" href="index.html"> 

<link id="next-page" rel="Next" type="text/html" href=""> 

<link id="previous-page" rel="Prev" type="text/html" href=""> 

<link rel="stylesheet" type="text/css" 
href="../../Resources/1282/CSS/screen.css"> 


<!-- xcode css --> 
<link rel="stylesheet" type="text/css" 
href="../../Resources/1282/CSS/feedback.css"> 
<meta name="viewport" content="width=device-width, initial-scale=1, 
maximum-scale=1"> 
<meta id="platforms" name="platforms" content=""> 


</head> 
<body class="" id=""><a name="//apple_ref/doc/uid/DTS10003591" 
title="Technical Note TN2127"></a> 
<div id="_omniture_top"> 
<!-- SiteCatalyst code version: H.8. Copyright 1997-2006 Omniture, Inc. --> 
<script type="text/javascript"> 
/* RSID: */ 
var s account="appleglobal,appleusdeveloper,dappdeveloperlib" 
</script> 


<script type="text/javascript" 

src="https://www.apple.com/metrics/scripts/s_code_h.js"></script> 
<script type="text/javascript"> 
s.pageName=AC.Tracking.pageName(); 
s.channel="www.us.developer" 


popepopopoper«x DO NOT ALTER ANYTHING BELOW THIS LINE |! Ferrero 
var s code=s.t();if(s_code)document.write(s_code)</script> 
<!-- End SiteCatalyst code version: H.8. --> 
</div> 
<div id="adcHeader" class="hideOnPrint hidelnxcode"> 
<div id="ssi_Header" class="hidelnXcode unified"> 
<a id="ssi_LibraryTitle" 
href="https://developer.apple.com/library/archive/navigation/" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
navigation/_1&quot;;return this.s_oc?this.s_oc(e):true">Documentation 
Archive</a> 
<a id="ssi_AppleDeveloperConnection" 
href="https://developer.apple.com/" 
onclick="s_objectID=&quot;https://developer.apple.com/_1&quot;;return 
this.s_oc?this.s_oc(e):true">Developer</a> 
<div id="ssi SearchButton" role="button" title="Search">Search</div> 
</div> 
<form id="ssi SearchMenu" method="get" action="../../search/" accept- 
charset="utf-8"> 
<label for="adcsearch">Search Documentation Archive</label> 


<input type="search" id="ssi_SearchField" name="q" accesskey="s" 
results="5"> 
</form> 
</div> 


<header id="header"> 
<div id="title" role="banner"> 
<h1>Kernel Authorization</h1> 
<span id="file_links"> 
<a id="PDF_link" role="button" tabindex="4" rel="alternate" 
title="Download PDF" class=""><span id="pdf_icon"></span>PDF</a> 
<a id="Companion link" role="button" tabindex="3" title="Download 
Companion File" class=""><span id="companion_icon"></span>Companion 
File</a> 
</span> 


</div> 
<ul id="headerButtons" class="hideOnPrint" role="toolbar"> 
<li id="toc_button" style="display:none"> 
<button tabindex="5" id="table of contents" class="" 
role="checkbox" aria-label="Show Table of Contents"><span 
class="disclosure"></span>Table of Contents</button> 
</li> 
<li id="jumpto_button" style="display:none" role="navigation"><select 
tabindex="6" id="jumpTo"><option value="top">Jump 
To...</option></select></li> 
«li id="downloadSample button" style="display:none"> 
«a id="Sample link"><button id="Sample_button">Download Sample 
Code</button></a> 
</li> 
</ul> 
</header> 
<nav id="tocContainer" tabindex="7" class=""> 
<ul id="toc" role="tree"></ul> 
</nav> 


<article id="contents" tabindex="0" role="main" class="dts_doc"> 
<!-- CONTENTS --> 
<div id="pageNavigationLinks top" class="pageNavigationLinks"> 


</div> 

<a id="top" name="top"></a> 

<a id="INDEX" href="index.html" style="display:none;" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
technotes/tn2127/index.html_1&quot;;return this.s oc?this.s_oc(e):true"></a> 


<a name="//apple_ref/doc/uid/DTS10003591-CH1-DontLinkElementID_2" 
title="Technical Note TN2127"></a><div class="dtsDocNumber">Technical 
Note TN2127</div><hl id="pageTitle">Kernel Authorization</h1><div 
class="importantbox 
clear"><aside><p><strong>Important:</strong>&nbsp;This document is no 
longer being updated. For the latest information about Apple SDKs, visit the 
<span class="content_text"><a 
href="https://developer.apple.com/documentation" class="urlLink" 
rel="external" 
onclick="s_objectID=&quot;https://developer.apple.com/documentation_1&quot; 
¡return this.s oc?this.s oc(e):true">documentation 
website</a></span>.</p><p></p></aside></div><p>Mac OS X 10.4 Tiger 
introduced a new kernel subsystem, Kernel Authorization or Kauth for short, for 
managing authorization within the kernel. The Kauth subsystem exports a kernel 
programming interface (KPI) that allows third party kernel developers to 
authorize actions within the kernel, modify authorization decisions, and extend 
the kernel's authorization landscape. It can also be used as a notification 
mechanism.</p><p>If you write code that interacts with the BSD portions of the 
Mac OS X kernel, you should read this technote to gain a passing familiarity with 
Kauth. If you need to perform any of the tasks list above, you'll want to study this 
technote in depth. Finally, if you're developing an anti-virus product for Mac OS 
X, you will need the information contained in this technote to implement "on 
access" and "post modification" file scanning.</p> 


<div class="outerMiniTOC"> 


<div> 
<a href="#//apple_ref/doc/uid/DTS10003591-CH1-SECTION1" data- 
renderer-version="1" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
technotes/tn2127/_index.html#//apple_ref/doc/uid/DTS1_1&quot;;return 
this.s_oc?this.s_oc(e):true">Kauth Fundamentals</a> 


</div> 


<div> 
<a href="#//apple_ref/doc/uid/DTS10003591-CH1-SECTION2" data- 
renderer-version="1" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
technotes/tn2127/_index.html#//apple_ref/doc/uid/DTS1_2&quot;;return 
this.s_oc?this.s_oc(e):true">Implementing a Listener</a> 


</div> 


<div> 
<a href="#//apple_ref/doc/uid/DTS10003591-CH1-SECTION3" data- 
renderer-version="1" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
technotes/tn2127/_index.html#//apple_ref/doc/uid/DTS1_3&quot;;return 
this.s_oc?this.s_oc(e):true">Registering a Listener</a> 


</div> 


<div> 
<a href="#//apple_ref/doc/uid/DTS10003591-CH1-SECTION4" data- 
renderer-version="1" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
technotes/tn2127/ index.html#//apple ref/doc/uid/DTS1 4&quot;;return 
this.s_oc?this.s_oc(e):true">Deregistering a Listener</a> 


</div> 


<div> 
<a href="4//apple ref/doc/uid/DTS10003591-CH1-SECTION5" data- 
renderer-version="1" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
technotes/tn2127/_index.html#//apple_ref/doc/uid/DTS1_ 5&quot;;return 
this.s_oc?this.s_oc(e):true">Registering a New Scope</a> 


</div> 


<div> 
<a href="#//apple_ref/doc/uid/DTS10003591-CH1-SECTION6" data- 
renderer-version="1" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
technotes/tn2127/ index.html#//apple ref/doc/uid/DTS1 6&quot;;return 
this.s oc?this.s oc(e):true">Deregistering a Scope</a> 


</div> 


<div> 
<a href="#//apple_ref/doc/uid/DTS10003591-CH1-SECTION7" data- 
renderer-version="1" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
technotes/tn2127/_index.html#//apple_ref/doc/uid/DTS1_7&quot;;return 
this.s oc?this.s oc(e):true">Authorizing an Action</a> 


</div> 


<div> 
<a href="4//apple ref/doc/uid/DTS10003591-CH1-SECTION8" data- 
renderer-version="1" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
technotes/tn2127/ index.html#//apple ref/doc/uid/DTS1 8&quot;;return 
this.s oc?this.s oc(e):true">Built-In Scopes</a> 


<div class="nestedMiniTOC"> 


<div> 
<a href="#//apple_ref/doc/uid/DTS10003591-CH1- 
SUBSECTIONS" data-renderer-version="1" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
technotes/tn2127/_index.html#//apple_ref/doc/uid/DTS1_9&quot;;return 
this.s_oc?this.s_oc(e):true">Process Scope</a> 


</div> 


<div> 
<a href="#//apple_ref/doc/uid/DTS10003591-CH1- 
SUBSECTION9" data-renderer-version="1" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
technotes/tn2127/_index.html#//apple_ref/doc/uid/DTS1_10&quot;;return 
this.s_oc?this.s_oc(e):true">Generic Scope</a> 


</div> 


<div> 
<a href="#//apple_ref/doc/uid/DTS10003591-CH1- 
SUBSECTION10" data-renderer-version="1" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
technotes/tn2127/_index.html#//apple_ref/doc/uid/DTS1_11&quot;;return 
this.s_oc?this.s_oc(e):true">File Operation Scope</a> 


</div> 


<div> 
<a href="#//apple_ref/doc/uid/DTS10003591-CH1- 
SUBSECTION11" data-renderer-version="1" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
technotes/tn2127/_index.html#//apple_ref/doc/uid/DTS1_12&quot;;return 
this.s_oc?this.s_oc(e):true">Vnode Scope</a> 


</div> 


</div> 


</div> 


<div> 
<a href="#//apple_ref/doc/uid/DTS10003591-CH1-SECTION14" data- 
renderer-version="1" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 


technotes/tn2127/_index.html#//apple_ref/doc/uid/DTS1_13&quot;;return 
this.s_oc?this.s_oc(e):true">Listener Gotchas</a> 


<div class="nestedMiniTOC"> 


<div> 
<a href="#//apple_ref/doc/uid/DTS10003591-CH1- 
SUBSECTION14" data-renderer-version="1" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
technotes/tn2127/_index.html#//apple_ref/doc/uid/DTS1_14&quot;;return 
this.s_oc?this.s_oc(e):true">Context</a> 


</div> 


</div> 


</div> 


<div> 
<a href="4//apple ref/doc/uid/DTS10003591-CH1-SECTION18" data- 
renderer-version="1" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
technotes/tn2127/_index.html#//apple_ref/doc/uid/DTS1_15&quot;;return 
this.s_oc?this.s_oc(e):true">Kauth Cookbook</a> 


<div class="nestedMiniTOC"> 


<div> 
<a href="#//apple_ref/doc/uid/DTS10003591-CH1- 
SUBSECTION18" data-renderer-version="1" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
technotes/tn2127/_index.html#//apple_ref/doc/uid/DTS1_16&quot;;return 
this.s_oc?this.s_oc(e):true">Denying the Debugger</a> 


</div> 


<div> 
<a href="#//apple_ref/doc/uid/DTS10003591-CH1- 
SUBSECTION19" data-renderer-version="1" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
technotes/tn2127/_index.html#//apple_ref/doc/uid/DTS1_17&quot;;return 
this.s_oc?this.s_oc(e):true">Anti-Virus Scanner</a> 


</div> 


<div> 
<a href="#//apple_ref/doc/uid/DTS10003591-CH1- 
SUBSECTION20" data-renderer-version="1" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
technotes/tn2127/_index.html#//apple_ref/doc/uid/DTS1_18&quot;;return 
this.s_oc?this.s_oc(e):true">New Kernel Subsystem</a> 


</div> 


</div> 


</div> 


<div> 
<a href="#//apple_ref/doc/uid/DTS10003591-CH1-SECTION22" data- 
renderer-version="1" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
technotes/tn2127/_index.html#//apple_ref/doc/uid/DTS1_19&quot;;return 
this.s oc?this.s oc(e):true">KauthORama Sample Code</a> 


</div> 


<div> 
<a href="#//apple_ref/doc/uid/DTS10003591-RevisionHistory- 
DontLinkElementID 1" data-renderer-version="1" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
technotes/tn2127/_index.html#//apple_ref/doc/uid/DTS1_20&quot;;return 
this.s_oc?this.s_oc(e):true">Document Revision History</a> 


</div> 


</div> 


<section><a name="//apple_ref/doc/uid/DTS10003591-CH1-SECTION1" 
title="Kauth Fundamentals"></a><h2 class="jump">Kauth 
Fundamentals</h2><p>The Kauth system was introduced in Mac OS X 10.4 
Tiger. It was implemented primarily to simplify the implementation of access 
control lists (ACLs), a major new feature of the Tiger kernel. Because evaluating 
an ACL is a complex task, the code for doing this has been abstracted out of 
each file system plug-in and moved into the kernel proper. Kauth does this in a 


general and flexible way.</p><p>While Kauth was originally designed to 
support ACLs, it is a general kernel authorization mechanism and can be used for 
a variety of other tasks. One such use is as a simple notification mechanism for 
anti-virus developers (see <span class="content text"><!--a -->Anti-Virus 
Scanner<!--/a--></span>).</p><p>To understand Kauth, you'll need to 
understand a number of core concepts.</p><ul class="ul"><li 
class="li"><p><strong>scopes</strong> — A scope is an area of interest for 
authorization within the kernel. For example, the scope 
<code>KAUTH SCOPE VNODE</code> is used for all authorization within the 
VFS layer. Scopes allow you to register interest in some subset of kernel 
authorization decisions, without being involved in all authorization 
decisions.</p><p>Scopes are strings formatted using reverse DNS notation (for 
example, <code>KAUTH SCOPE VNODE</code> is 
<code>"com.apple.kauth.vnode"</code>), so you can define your own scope if 
you like.</p></li><li class="li"><p><strong>actions</strong> — An action is 
an operation within a scope. For example, the VFS subsystem defines an action, 
<code>KAUTH_VNODE_READ_DATA</code>, which determines whether you're 
allowed to read data from a file system object. Actions are specified by integer 
constants (the actual type is <code>kauth_action_t</code>) and each scope 
has its own action namespace.</p><p>The combination of a scope and an 
action defines an operation whose authorization can be checked.</p></li><li 


class="li"><p><strong>actors</strong> — An actor is an entity that's 
performing an operation.</p></li><li 
class="li"><p><strong>credentials</strong> — Credentials are the information 


that identifies an actor. Credentials are specified by an opaque type, 
<code>kauth_cred_t</code>. There are numerous accessor functions that let 
you operate on this type. For example, <code>kauth_cred_getuid</code> 
returns the effective user ID (EUID) from the credentials.</p></li><li 


class="li"><p><strong>request</strong> — In the context of this document, 
an actor makes requests to perform an action within a particular 
scope. </p></li><li class="li"><p><strong>listener</strong> — A listener is a 


callback that makes an authorization decision for a request. Fundamentally the 
listener authorizes the request based on the credentials of the actor. The listener 
is free to use whatever scope- and action-dependent information necessary to 
make that decision.</p><p>There is a <strong>default listener</strong> for 
every built-in scope. This listener implements the standard BSD authorization 
model for all actions within that scope. In addition, you can register your own 
listeners for a scope.</p></li></ul><div class="back to top"><a href="#top" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
technotes/tn2127/_index.html#top_1&quot;;return this.s oc? 
this.s_oc(e):true">Back to Topx/a» «/div» «/section» «section» «a 
name="//apple_ref/doc/uid/DTS10003591-CH1-SECTION2" title="Implementing a 
Listener"></a><h2 class="jump">Implementing a Listener</h2><p>The 
prototype for a listener is shown in <span class="content text"»«!--a -->Listing 
1<!--/a--></span>.</p><a name="//apple ref/doc/uid/DTS10003591-CH1- 
SOURCECODE1" title="Listing 1Prototype for a listener"></a><p 
class="codesample clear"><strong class="caption_number">Listing 
1</strong>&nbsp;&nbsp;Prototype for a listener</p><div class="codesample 
clear"><table><tbody><tr><td scope="row"><pre>static int MyListener( 

kauth cred t credential, 

void * idata, 

kauth_action_t action, 

uintptr_t argO, 

uintptr_t argl, 


uintptr_t arg2, 

uintptr_t arg3 
);<span></span></pre></td></tr></tbody></table></div><p>The meaning 
of the first three arguments is the same for all scopes.</p><ul class="ul"><li 
class="li"><p><code>credential</code> is a reference to the actor's 
credentials.</p><div class="importantbox clear"><aside><a 
name="//apple ref/doc/uid/DTS10003591-CH1-DontLinkElementID 3" 
title="Important"></a><p><strong>Important:</strong>&nbsp; When 
inspecting the credentials associated with a request, always use the accessor 
functions defined in &lt;sys/kauth.h&gt;. Be especially careful when testing for 
group membership. In Tiger a user can be in lots of groups (many more than the 
traditional limit of 16) and groups can be nested. If you want to test whether a 
user is a member of a group, use 
<code>kauth_cred_ismember_gid</code>.</p><p></p></aside></div></li> 
«li class="li"><p><code>idata</code> is the cookie (or refCon) data you 
supplied when you registered the listener (see <span class="content text"><!-- 
a -->Registering a Listener<!--/a--></span>).</p></li><li 
class="li"><p><code>action</code> is the requested action (for example, 
<code>KAUTH VNODE READ DATA</code>).</p></li></ul><p>The meaning 
of the remaining parameters is scope dependent. I'll discuss these in detail in 
later sections. However, in most cases these parameters give you extra 
information that allow you to make an authorization decision. For example, for 
the VFS scope (<code>KAUTH SCOPE VNODE</code>), <code>argl</code> is 
a reference to the vnode (of type <code>vnode t</code>) that's being operated 
on.</p><p>A listener callback must return one of the following values.</p><ul 
class="ul"><li class="li"><p><code>KAUTH RESULT DEFER</code> — This 
value indicates that the listener defers the decision about this request to the 
other listeners (and ultimately to the default listener).</p></li><li 
class="li"><p><code>KAUTH RESULT ALLOW«/code» — This value indicates 
that, as far as this listener is concerned, the request is allowed.</p></li><li 
class="li"><p><code>KAUTH RESULT DENY«/code» — This value indicates 
that the request should be denied.</p></li></ul><p>For a request to be 
allowed, at least one listener must return 
<code>KAUTH RESULT ALLOW«/code» and no listeners can return 
<code>KAUTH RESULT DENY«/code». This has a number of 
consequences.</p><ul class="ul"><li class="li"><p>All listeners are called for 
all requests (because the last listener just might return 
<code>KAUTH RESULT DENY</code>).</p></li><li class="li"><p>Because a 
listener can't allow a request that's denied by any other listener, a non-default 
listener can only tighten security.</p></li></ul><p>When writing a listener, 
there are a number of important points that you need to keep in mind. These are 
discussed in the detail in <span class="content text"><!--a -->Listener 
Gotchas<!--/a--></span>.</p><div class="back to top"><a href="#top" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
technotes/tn2127/ index.html#top 2&quot;;return this.s oc? 
this.s_oc(e):true">Back to Top</a></div></section><section><a 
name="//apple ref/doc/uid/DTS10003591-CH1-SECTION3" title="Registering a 
Listener"></a><h2 class="jump">Registering a Listener</h2><p>You can 
register a listener for an existing scope using 
<code>kauth listen scope</code>.</p><a 
name="//apple ref/doc/uid/DTS10003591-CH1-SOURCECODE?" title="Listing 
2kauth listen scope"></a><p class="codesample clear"><strong 
class="caption number">Listing 
2</strong>&nbsp;&nbsp;kauth listen scope</p><div class="codesample 


clear"><table><tbody><tr><td scope="row"><pre>extern kauth_listener_t 
kauth_listen_scope( const char * identifier, kauth scope callback t 
callback, void * idata 
);<span></span></pre></td></tr></tbody></table></div><p>The 
parameters are as follows:</p><ul class="ul"><li 
class="li"><p><code>identifier</code> is the name of the scope. The routine 
does not make a copy of the string pointed to by this parameter. This is not a 
problem if you're passing a constant string; however, if you're calculating the 
string at runtime, you must make sure that the string persists until you dispose 
of the resulting <code>kauth_listener_t</code>.</p></li><li 
class="li"><p><code>callback</code> is the address of your listener callback 
function, with the prototype shown in <span class="content text"><!--a -- 
>Listing 1<!--/a--></span>.</p></li><li class="li"><p><code>idata</code> 
is the cookie (or refCon) for your listener callback.</p></li></ul><p>On error, 
the result is <code>NULL</code>. On success, the result is a reference to the 
listener; you can use this to deregister your listener.</p><p>lt is not an error to 
register a listener before the corresponding scope is registered. The system will 
remember your listener and apply it once the scope appears.</p><div 
class="back to top"><a href="#top" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
technotes/tn2127/_index.html#top_3&quot;;return this.s oc? 
this.s oc(e):true">Back to Top</a></div></section><section><a 
name="//apple ref/doc/uid/DTS10003591-CH1-SECTION4" title="Deregistering a 
Listener"></a><h2 class="jump">Deregistering a Listener</h2><p>You can 
deregister a listener using <code>kauth unlisten scope</code>.</p><a 
name="//apple ref/doc/uid/DTS10003591-CH1-SOURCECODE3" title="Listing 
3kauth unlisten scope"></a><p class="codesample clear"><strong 
class="caption number">Listing 
3</strong>&nbsp;&nbsp;kauth unlisten scope</p><div class="codesample 
clear"><table><tbody><tr><td scope="row"><pre>extern void 

kauth unlisten scope(kauth listener t 
listener); <span></span></pre></td></tr></tbody></table></div><p>The 
parameters are as follows:</p><ul class="ul"><li 
class="li"><p><code>listener</code> is a reference to the listener you got 
from <code>kauth_listen_scope</code>.</p></li></ul><div 
class="importantbox clear"><aside><a 
name="//apple ref/doc/uid/DTS10003591-CH1-DontLinkElementID 4" 
title="Important"></a><p><strong>Important:</strong>&nbsp;The return of 
<code>kauth_unlisten_scope</code> does not guarantee that all threads 
executing your listener have returned from your listener. Once 
<code>kauth_unlisten_scope</code> returns, you must take steps to avoid 
destroying state that these threads rely on until they've completed executing 
your listener's code. See <span class="content_text"><!--a -->KauthORama 
Sample Code<!--/a--></span> for an example of our recommended approach for 
this.</p><p></p></aside></div><div class="back_to_top"><a href="#top" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
technotes/tn2127/ index.html#top_4&quot;;return this.s oc? 
this.s_oc(e):true">Back to Top</a></div></section><section><a 
name="//apple ref/doc/uid/DTS10003591-CH1-SECTION5" title="Registering a 
New Scope"></a><h2 class="jump">Registering a New Scope</h2><div 
class="importantbox clear"><aside><a 
name="//apple ref/doc/uid/DTS10003591-CH1-DontLinkElementID 5" 
title="Important"></a><p><strong>Important:</strong>&nbsp;You should 
only do this if you want to create your own custom scope. In most cases third 


party developers should register a listener for an existing 
scope. </p><p></p></aside></div><p>You can register a new scope using 
<code>kauth register scope</code>.</p><a 
name="//apple_ref/doc/uid/DTS10003591-CH1-SOURCECODE4" title="Listing 
4kauth_register_scope"></a><p class="codesample clear"><strong 
class="caption_number">Listing 
4</strong>&nbsp;&nbsp;kauth register scope</p><div class="codesample 
clear"><table><tbody><tr><td scope="row"><pre>extern kauth scope t 
kauth register scope( const char * identifier, kauth scope callback t 
callback, void * idata 
);<span></span></pre></td></tr></tbody></table></div><p>The 
parameters are as follows:</p><ul class="ul"><li 
class="li"><p><code>identifier</code> is the name of the scope. It is an error 
to register a scope that already exists. The routine does not make a copy of the 
string pointed to by this parameter. This is not a problem if you're passing a 
constant string; however, if you're calculating the string at runtime, you must 
make sure that the string persists at least until you dispose of the resulting 
<code>kauth scope t</code>.</p></li><li 
class="li"><p><code>callback</code> is the address of the listener callback 
function for this scope; this becomes the scope's default listener. This parameter 
may be <code>NULL</code>, in which case a callback that always returns 
<code>KAUTH RESULT DEFER</code> is assumed.</p></li><li 
class="li"><p><code>idata</code> is the cookie (or refCon) for the listener 
callback.</p></li></ul><p>On error, the result is <code>NULL</code>. On 
Success, the result is a reference to the scope; you can use this to deregister 
your scope. </p><div class="back to top"><a href="#top" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
technotes/tn2127/_index.html#top_5&quot;;return this.s oc? 
this.s oc(e):true">Back to Top</a></div></section><section><a 
name="//apple ref/doc/uid/DTS10003591-CH1-SECTION6" title="Deregistering a 
Scope"></a><h2 class="jump">Deregistering a Scope</h2><p>You can 
deregister a scope using <code>kauth deregister scope</code>:</p><a 
name="//apple ref/doc/uid/DTS10003591-CH1-SOURCECODE5" title="Listing 
5kauth deregister scope"></a><p class="codesample clear"=» «strong 
class="caption_number">Listing 
5</strong>&nbsp;&nbsp;kauth deregister scope</p><div class="codesample 
clear" ><table><tbody><tr><td scope="row"><pre>extern void 

kauth deregister scope(kauth scope t 
scope);<span></span></pre></td></tr></tbody></table></div><p>The 
parameters are as follows:</p><ul class="ul"><li 
class="li"><p><code>scope</code> is a reference to the scope you got from 
<code>kauth_register_scope</code>.</p></li></ul><p>Any other (non- 
default) listeners registered on the scope will go dormant; they'll be reactivated 
if the scope is reregistered.</p><div class="importantbox clear"><aside><a 
name="//apple ref/doc/uid/DTS10003591-CH1-DontLinkElementID 6" 
title="Important"></a><p><strong>Important:</strong>&nbsp;The return of 
<code>kauth deregister scope</code> does not guarantee that all threads 
executing your listener have returned from your listener. See the discussion 
associated with <code>kauth_unlisten_scope</code> (in <span 
class="content_text"><!--a -->Deregistering a Listener<!--/a--></span>) for 
details.</p><p></p></aside></div><div class="back to top"><a 
href="#top" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
technotes/tn2127/_index.html#top_6&quot;;return this.s oc? 


this.s_oc(e):true">Back to Top</a></div></section><section><a 
name="//apple_ref/doc/uid/DTS10003591-CH1-SECTION7" title="Authorizing an 
Action"></a><h2 class="jump">Authorizing an Action</h2><p>You can make 
an authorization request using <code>kauth_authorize_action</code>.</p><a 
name="//apple ref/doc/uid/DTS10003591-CH1-SOURCECODE6" title="Listing 
6kauth authorize action"></a><p class="codesample clear"><strong 
class="caption number">Listing 
6</strong>&nbsp;&nbsp;kauth_authorize_action</p><div class="codesample 
clear"><table><tbody><tr><td scope="row"><pre>extern int 
kauth_authorize_action( 

kauth_scope t scope, 

kauth cred t credential, 

kauth_action_t action, 

uintptr_t argO, 

uintptr t argl, 

uintptr t arg2, 

uintptr t arg3 
);<span></span></pre></td></tr></tbody></table></div><p>The 
parameters are as follows:</p><ul class="ul"><li 
class="li"><p><code>scope</code> is a reference to the scope in which the 
action is defined. You get this value from the result of 
<code>kauth register scope</code>.</p></li><li 
class="li"><p><code>credential</code> is a reference to the actor's 
credentials. Normally you would either already have this information, or you'd 
call <code>kauth_cred_get</code> to get the credentials for the current 
thread.</p></li><li class="li"><p><code>action</code> is the requested 
action.</p></li><li class="li"><p><code>arg0</code> through 
<code>arg3</code> are passed unmodified to the listener 
callbacks.</p></li></ul><p>If your kernel extension supports plug-ins and 
those plug-ins call <code>kauth authorize action</code>, you must have a way 
for your plug-ins to discover the scope reference 
(<code>kauth scope t</code>). The easiest way to do this is to export a 
wrapper function that's tailored to your specific requirements.</p><div 
class="importantbox clear"><aside><a 
name="//apple ref/doc/uid/DTS10003591-CH1-DontLinkElementID 7" 
title="Important"></a><p><strong>Important:</strong>&nbsp;The kernel 
already provides <code>kauth authorize action</code> wrappers for all of the 
scopes that it defines. If you're authorizing within a kernel-defined scope you 
should call these wrappers rather than calling 
<code>kauth_authorize_action</code> directly. These wrappers are described 
below, along with corresponding scopes.</p><p></p></aside></div><div 
class="back to top"><a href="#top" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
technotes/tn2127/_index.html#top_7&quot;;return this.s oc? 
this.s_oc(e):true">Back to Top</a></div></section><section><a 
name="//apple ref/doc/uid/DTS10003591-CH1-SECTIONS" title="Built-In 
Scopes"></a><h2 class="jump">Built-In Scopes</h2><p>This section lists all 
of the scopes built in to the Mac OS X kernel.</p><section><a 
name="//apple ref/doc/uid/DTS10003591-CH1-SUBSECTIONS" title="Process 
Scope"></a><h3 class="jump">Process Scope</h3><p>The process scope 
(<code>KAUTH SCOPE PROCESS</code>, which is 
<code>"com.apple.kauth.process"</code>) is the easiest to understand. It 
defines just two actions.</p><ul class="ul"><li 
class="li"><p><code>KAUTH PROCESS CANTRACE</code> — 


&nbsp;Authorizes whether the current process can trace the target process. 
<code>arg0</code> (of type <code>proc_t</code>) is the process being 
traced. <code>argl</code> (of type <code>(int *)</code>) is a pointer to an 
an errno-style error code; if the listener denies the request, it must set this value 
to a non-zero value.</p></li><li 
class="li"><p><code>KAUTH PROCESS CANSIGNAL</code> — 
&nbsp;Authorizes whether the current process can signal the target process. 
<code>arg0</code> (of type <code>proc_t</code>) is the process to be 
signalled. <code>argl</code> (of type <code>int</code>) is the signal that's 
being sent.</p><div class="importantbox clear"><aside><a 
name="//apple ref/doc/uid/DTS10003591-CH1-DontLinkElementID 8" 
title="Important"></a><p><strong>Important:</strong>&nbsp;<code>KAUTH 
_PROCESS_CANSIGNAL</code> is currently not implemented by any version of 
Mac OS X (r. <span class="content_text"><a href="rdar://problem/3931697" 
class="urlLink" rel="external" 
onclick="s_objectID=&quot;rdar://problem/3931697_1&quot;;return this.s oc? 
this.s_oc(e):true">3931697</a></span>).</p><p></p></aside></div></ 
li></ul><p>The kernel also exports a <code>kauth_authorize_action</code> 
wrapper for this scope, namely 
<code>kauth_authorize_process</code>.</p><a 
name="//apple ref/doc/uid/DTS10003591-CH1-SOURCECODET" title="Listing 
7kauth_authorize_process"></a><p class="codesample clear"><strong 
class="caption_number">Listing 
7</strong>&nbsp;&nbsp;kauth_authorize_process</p><div class="codesample 
clear"><table><tbody><tr><td scope="row"><pre>extern int 
kauth_authorize_process( 

kauth cred t credential, 

kauth action t action, 

proc t process, 

uintptr t argl, 

uintptr t arg2, 

uintptr t arg3 
);<span></span></pre></td></tr></tbody></table></div><p>This wrapper 
around <code>kauth authorize action</code> does two useful things:</p><ol 
class="ol"><li class="li"><p>It supplies the appropriate scope 
parameter.</p></li><li class="li"><p>It eliminates the need to cast 
<code>process</code> (of type <code>proc_t</code>) to 
<code>arg0</code> (of type 
<code>uintptr_t</code>).</p></li></ol><p>Typically this is not useful for 
third party developers.</p></section><section><a 
name="//apple ref/doc/uid/DTS10003591-CH1-SUBSECTION9" title="Generic 
Scope"></a><h3 class="jump">Generic Scope</h3><p>The generic scope 
(<code>KAUTH SCOPE GENERIC</code>, which is 
<code>"com.apple.kauth.generic"</code>) has a single action, 
<code>KAUTH GENERIC ISSUSER</code>, which the kernel requests to test 
whether an actor has superuser privileges. None of the generic arguments 
(<code>arg0</code> through <code>arg3</code>) are significant.</p><div 
class="importantbox clear"><aside><a 
name="//apple ref/doc/uid/DTS10003591-CH1-DontLinkElementID 9" 
title="Important"></a><p><strong>Important:</strong>&nbsp;The kernel 
does not currently use this request for all superuser tests; in many cases the 
kernel continues to directly compare the credential's effective user ID to 
0.</p><p></p></aside></div><p>The kernel also exports a 
<code>kauth_authorize_action</code> wrapper for this scope, namely 


<code>kauth_authorize_generic</code>.</p><a 

name="//apple ref/doc/uid/DTS10003591-CH1-SOURCECODES" title="Listing 
8kauth authorize generic"></a><p class="codesample clear"» «strong 
class="caption_number">Listing 
8</strong>&nbsp;&nbsp;kauth authorize generic</p><div class="codesample 
clear"><table><tbody><tr><td scope="row"><pre>extern int 

kauth authorize generic( kauth_cred_t credential, kauth action t 
action 
);<span></span></pre></td></tr></tbody></table></div><p>Typically this 
is not useful for third party developers.</p></section><section><a 
name="//apple_ref/doc/uid/DTS10003591-CH1-SUBSECTION10" title="File 
Operation Scope"></a><h3 class="jump">File Operation Scope</h3><p>The 
file operation scope (<code>KAUTH SCOPE FILEOP</code>, which is 
<code>"com.apple.kauth.fileop"</code>) is different from other scopes in that 
it's not used to actually authorize an operation; rather, the system uses this 
scope to notify listeners of significant file system operations. This can be used to 
implement an anti-virus scanning program, as described in <span 
class="content text"><!--a -->Anti-Virus 
Scanner<!--/a--></span>.</p><p><code>KAUTH SCOPE FILEOP</code> 
defines the following actions.</p><ul class="ul"><li 
class="li"><p><code>KAUTH FILEOP OPEN</code> —&nbsp; Notifies that a file 
system object (a file or directory) has been opened. <code>arg0</code> (of 
type <code>vnode t</code>) is a vnode reference. <code>arg1</code> (of 
type <code>(const char *)</code>) is a pointer to the object's full 
path.</p></li><li class="li"><p><code>KAUTH_FILEOP_CLOSE</code> — 
Notifies that a file system object is about to be closed. <code>arg0</code> (of 
type <code>vnode t«/code») is a vnode reference. <code>arg1</code> (of 
type <code>(const char *)</code>) is a pointer to the object's full path. 
<code>arg2</code> (of type <code>int</code>) is a set of bit flags; the only 
flag currently defined is <code>KAUTH_FILEOP_CLOSE_MODIFIED</code>, which 
is set if a modified file is being closed.</p></li><li 
class="li"><p><code>KAUTH FILEOP RENAME</code> —&nbsp;Notifies that a 
file system object has been renamed. <code>arg0</code> (of type 
<code>(const char *)</code>) is a pointer to the object's previous full path. 
<code>argl</code> (of type <code>(const char *)</code>) is a pointer to the 
object's new full path.</p></li><li 
class="li"><p><code>KAUTH FILEOP EXCHANGE</code> —&nbsp;Notifies that 
two files have been exchanged (via <span class="content text"><a href="x- 
man-page://2/exchangedata" class="urlLink" rel="external" 
onclick="s_objectID=&quot;x-man-page://2/exchangedata_1&quot;;return 
this.s_oc?this.s_oc(e):true">exchangedata</a></span>). <code>arg0</code> 
(of type <code>(const char *)</code>) is a pointer to the first file's full path. 
<code>argl</code> (of type <code>(const char *)</code>) is a pointer to the 
second file's full path.</p></li><li 
class="li"><p><code>KAUTH FILEOP LINK</code> —&nbsp;Notifies that a new 
hard link has been added to a file (via the <span class="content_text"><a 
href="x-man-page://2/link" class="urlLink" rel="external" 
onclick="s_objectID=&quot;x-man-page://2/link_1&quot;;return this.s oc? 
this.s_oc(e):true">link</a></span> system call). <code>arg0</code> (of type 
<code>(const char *)</code>) is a pointer to the full path of the original file. 
<code>argl</code> (of type <code>(const char *)</code>) is a pointer to the 
full path of the newly created link.</p></li><li 
class="li"><p><code>KAUTH FILEOP EXEC</code> —&nbsp;Notifies that a 
program has been executed (via the <span class="content_text"><a href="x- 


man-page://2/execve" class="urlLink" rel="external" 
onclick="s_objectID=&quot;x-man-page://2/execve_1&quot;;return this.s oc? 
this.s oc(e):true">execve</a></span> system call). <code>arg0</code> (of 
type <code>vnode t«/code») is a vnode reference of the program being 
executed (for Mach-O executables, this is the actual executable; for CFM 
applications, this will always reference <code>LaunchCFMApp</code>; for 
interpreted scripts, such as shell or perl scripts, this is the script, not the 
interpreter). <code>argl</code> (of type <code>(const char *)</code>) is a 
pointer to the program file's full path.</p></li></ul><p>If you install a listener 
in this scope, it will be called to notify you of these events. The kernel ignores 
the return value of your listener, although we recommend that you always return 
<code>KAUTH_RESULT_DEFER</code>.</p><div class="warningbox 
clear"><aside><a name="//apple_ref/doc/uid/DTS10003591-CH1- 
DontLinkElementID 10" 
title="Warning"></a><p><strong>Warning:</strong>&nbsp;Prior to Mac OS X 
10.5 the file operation scope had a nasty gotcha 

(r. <span class="content text"><a 
href="rdar://problem/4605516" class="urlLink" rel="external" 
onclick="s objectID=&quot;rdar://problem/4605516 1&quot;;return this.s oc? 
this.s_oc(e):true">4605516</a></span>) 

. If you install a listener in the this scope and handle the 
<code>KAUTH_FILEOP_RENAME</code>, <code>KAUTH_FILEOP_LINK</code>, 
or <code>KAUTH_FILEOP_EXEC</code> actions, you must test whether 
<code>arg0</code> and <code>argl</code> are <code>NULL</code> 
before accessing them as strings. Under certain circumstances (most notably, 
very early in the boot sequence and very late in the shutdown sequence), the 
kernel might pass you <code>NULL</code> for these arguments. If you access 
such a pointer as a string, you will kernel panic.</p><p></p><div 
class="clear"></div></aside></div><p>This problem was fixed in Mac OS X 
10.5.</p><p>The kernel also exports a <code>kauth_authorize_action</code> 
wrapper for this scope, namely <code>kauth authorize fileop</code>.</p><a 
name="//apple ref/doc/uid/DTS10003591-CH1-SOURCECODEO" title="Listing 
Okauth authorize fileop"></a><p class="codesample clear"><strong 
class="caption number">Listing 
9</strong>&nbsp;&nbsp;kauth authorize fileop</p><div class="codesample 
clear"><table><tbody><tr><td scope="row"><pre>extern int 
kauth authorize fileop( kauth_cred_t credential, kauth_action_t action, 
uintptr_t argo, uintptr_t argl 
);<span></span></pre></td></tr></tbody></table></div><p>Typically 
<code>kauth_authorize fileop</code> is not useful for third party developers. 
However, if you do call it, take note of the following non-obvious behaviour. The 
<code>arg0</code> parameter of <code>kauth authorize fileop</code> is a 
<code>vnode t</code>. <code>kauth authorize fileop</code> passes that 
<code>vnode t</code> to the <code>arg0</code> parameter of the listener. 
It also gets the path to that vnode and passes that to the <code>arg1</code> 
parameter of the listener. Finally, for the <code>KAUTH_FILEOP_CLOSE</code> 
action, <code>kauth_authorize fileop</code> passes its <code>argl</code> 
parameter to the <code>arg2</code> parameter of the 
listener.</p></section><section><a name="//apple_ref/doc/uid/DTS10003591- 
CH1-SUBSECTION11" title="Vnode Scope"></a><h3 class="jump">Vnode 
Scope</h3><p>The vnode scope (<code>KAUTH SCOPE VNODE</code>, 
which is <code>"com.apple.kauth.vnode"</code>) is the most complex scope 
currently defined. The first thing to note is that, within the vnode scope, actions 
are not enumerations but rather bitfields. Thus, it's perfectly reasonable to 


combine actions by ORing them together. For example, an action of 
<code>KAUTH VNODE READ DATA</code> | 
<code>KAUTH VNODE EXECUTE</code> indicates that actor wishes to both 
read and execute the file.</p><p>To authorize an action within the vnode 
scope, you would call <code>vnode authorize</code>.</p><a 

name="//apple ref/doc/uid/DTS10003591-CH1-SOURCECODE10" title="Listing 
10vnode authorize"></a><p class="codesample clear"><strong 
class="caption number">Listing 

10</strong>&nbsp;&nbsp;vnode authorize</p><div class="codesample 
clear"><table><tbody><tr><td scope="row"><pre>extern int 

vnode authorize( vnode t vp, vnode t dvp, kauth_action_t 
action, vfs_context_t context 
);<span></span></pre></td></tr></tbody></table></div><p>The 
parameters are as follows:</p><ul class="ul"><li 
class="li"><p><code>vp</code> is the vnode on which the action is being 
performed.</p></li><li class="li"><p><code>dvp</code> is the parent 
directory's vnode. In many cases this is <code>NULL</code>, indicating that 
the parent is unknown or irrelevant.</p></li><li 
class="li"><p><code>action</code> is the operation being performed; this is 
discussed in detail below.</p></li><li class="li"><p><code>context</code> 
is the VFS context associated with the actor. This is an opaque data structure 
that's intimately tied to the VFS implementation. Most VFS entry points are 
passed this context. In addition, there are numerous VFS context routines 
defined in 
&lt;sys/vnode.h&gt;.</p></li></ul><p><code>vnode authorize</code> is a 
fairly simple wrapper around <code>kauth_authorize_action</code>. It 
performs two useful functions:</p><ol class="ol"><li class="li"><p>lIt 
assembles the correct scope listener arguments (<code>arg0</code> through 
<code>arg3</code>). These are discussed below.</p></li><li 
class="li"><p>It ensures that the error code is correct. Specifically, it translates 
the <code>EPERM</code> error returned by 
<code>kauth_authorize_action</code> into <code>EACCES</code> (which is 
the appropriate error for file system functions). Also, if the listener denies a 
request and provides a specific error code (via <code>arg3</code>, see below), 
it returns that error.</p></li></ol><div class="importantbox 
clear"><aside><a name="//apple_ref/doc/uid/DTS10003591-CH1- 
DontLinkElementID 11" 
title="Important"></a><p><strong>Important:</strong>&nbsp;lt is relatively 
unusual for a VFS plug-in to call <code>vnode_authorize</code>. In most cases 
the VFS layer has authorized all actions before calling your plug-in. However, 
there are some circumstances where a VFS plug-in should call 
<code>vnode_authorize</code>. For example, HFS [Plus]'s implementation of 
<span class="content_text"><a href="x-man-page://2/searchfs" class="urlLink" 
rel="external" 
onclick="s_objectID=&quot;x-man-page://2/searchfs_1&quot;;return this.s oc? 
this.s_oc(e):true">searchfs</a></span> uses <code>vnode authorize</code> 
to ensure that the caller has access to the file system objects that it's 
returning.</p><p></p></aside></div><p>The scope listener arguments for 
the vnode scope are as follows:</p><ul class="ul"><li 


class="li"><p><code>arg0</code>, of type <code>vfs context t</code>, is 
<code>context</code> — The VFS context, described above.</p></li><li 
class="li"><p><code>argl</code>, of type <code>vnode t«/code», is 


<code>vp</code> — The vnode itself.</p></li><li 
class="li"><p><code>arg2</code>, of type <code>vnode t«/code», is 


<code>dvp</code> — The parent vnode, if available. This may be 
<code>NULL</code>.</p></li><li class="li"><p><code>arg3</code>, of 
type <code>(int *)</code>, is <code>errPtr</code> — A pointer to an errno- 
style error. If your callback denies the request, it can set this value to indicate 
the error to return to the client. If you don't set this, the client gets 
<code>EACCES</code>.</p></li></ul><p>Within the vnode scope, the 
following standard actions are defined.</p><ul class="ul"><li 
class="li"><p><code>KAUTH VNODE READ DATA</code> (also 
<code>KAUTH VNODE LIST DIRECTORY</code>) — If the vnode is a directory, 
authorizes the actor to enumerate the contents of that directory. Otherwise, 
authorizes the actor to read the contents of a file.</p></li><li 
class="li"><p><code>KAUTH VNODE WRITE DATA</code> (also 
<code>KAUTH VNODE ADD FILE</code>) — If the vnode is a directory, 
authorizes the actor to add a file to that directory. <code>vp</code> is the 
directory to which the file is being added; <code>dvp</code> is 
<code>NULL</code>. Otherwise, authorizes the actor to write the contents of a 
file.</p></li><li class="li"><p><code>KAUTH VNODE EXECUTE</code> (also 
<code>KAUTH VNODE SEARCH</code>) — If the vnode is a directory, 
authorizes the actor to probe for the existence of an item within the directory as 
part of a path lookup. Otherwise, authorizes the actor to execute the contents of 
a file.</p></li><li class="li"><p><code>KAUTH VNODE DELETE</code> — 
Authorizes the actor to delete an item from a directory. <code>vp</code> is the 
item to be deleted and <code>dvp</code> is the directory it's being deleted 
from.</p></li><li 
class="li"><p><code>KAUTH VNODE APPEND DATA«/code» (also 
<code>KAUTH VNODE ADD SUBDIRECTORY«/code») — If the vnode is a 
directory, authorizes the actor to add a directory to it. Otherwise, this action is 
intended to authorize the actor to append data to the contents of a file; however, 
this aspect is not currently implemented.</p></li><li 
class="li"><p><code>KAUTH VNODE DELETE CHILD</code> — When used in 
a directory's ACL, this permission controls whether the actor can delete an item 
from the directory. That is, for the actor to be able to delete the item, they must 
have <code>KAUTH VNODE DELETE</code> permission on the item and 
<code>KAUTH VNODE DELETE CHILD</code> permission on the item's parent 
directory.</p><p>A Kauth listener, however, rarely sees this action. When an 
actor deletes an item, the kernel just authorizes the 
<code>KAUTH VNODE DELETE«/code» action on the item itself; it does not 
authorize a separate <code>KAUTH VNODE DELETE CHILD</code> action on 
the parent directory. Rather, the default listener for the vnode scope will check 
the <code>KAUTH VNODE DELETE CHILD</code> permission on the parent 
directory directly, without another pass through Kauth. This improves 
performance and avoids a potential race condition.</p><p>On the other hand, 
a <code>KAUTH VNODE DELETE CHILD</code> action is generated in response 
to an <span class="content text"><a href="x-man-page://2/access" 
class="urlLink" rel="external" 

onclick="s objectID=&quot;x-man-page://2/access 1&quot;;return this.s oc? 
this.s_oc(e):true">access</a></span> system call with the 

«code» RMFILE OK«/code» flag.</p></li><li 
class="li"><p><code>KAUTH VNODE READ ATTRIBUTES</code> — Authorizes 
the actor to read standard attributes of the vnode (such as the time 
stamps).</p></li><li 
class="li"><p><code>KAUTH VNODE WRITE ATTRIBUTES</code> — 
Authorizes the actor to change standard attributes of the vnode (such as the 
time stamps).</p></li><li 


class="li"><p><code>KAUTH VNODE READ EXTATTRIBUTES</code> — 
Authorizes the actor to read extended attributes of the vnode (those accessed 
via <code>getxattr</code>, including the resource fork).</p></li><li 
class="li"><p><code>KAUTH VNODE WRITE EXTATTRIBUTES</code> — 
Authorizes the actor to change (or add) extended attributes of the vnode (those 
accessed via <code>getxattr</code>, including the resource fork).</p></li><li 
class="li"><p><code>KAUTH VNODE READ SECURITY</code> — Authorizes 
the actor to read the vnode's ACL.</p></li><li 
class="li"><p><code>KAUTH VNODE WRITE SECURITY</code> — Authorizes 
the actor to change the vnode's ACL.</p></li><li 
class="li"><p><code>KAUTH VNODE TAKE OWNERSHIP</code> — Authorizes 
the actor to change ownership of the vnode.</p></li><li 
class="li"><p><code>KAUTH VNODE SYNCHRONIZE</code> — This 
represents an ACL permission that is defined for compatibility with other 
platforms. It is preserved but not tested by Mac OS X. Hence, it is never used as 
a Kauth action.</p></li><li 
class="li"><p><code>KAUTH VNODE LINKTARGET</code> — Authorizes the 
actor to make a new hard link to the vnode.</p></li><li 
class="li"><p><code>KAUTH VNODE CHECKIMMUTABLE</code> — Authorizes 
the actor to modify the file (in the <code>SF IMMUTABLE</code> sense; see 
<span class="content text"><a href="x-man-page://2/chflags" class="urlLink" 
rel="external" 

onclick="s objectID=&quot;x-man-page://2/chflags 1&quot;;return this.s oc? 
this.s_oc(e):true">chflags</a></span>). This flag is set if other checks have 
already been made to check that the file can by modified, but the modification 
should still fail for immutable files.</p></li><li 
class="li"><p><code>KAUTH VNODE ACCESS</code> — This is a special flag. 
If this flag is set the authorization request is advisory (for example, to satisfy an 
<span class="content_text"><a href="x-man-page://2/access" class="urlLink" 
rel="external" 

onclick="s objectID=&quot;x-man-page://2/access 2&quot;;return this.s oc? 
this.s_oc(e):true">access</a></span> system call) rather than authoritative. A 
listener can use this to avoid doing extra work in the advisory case.</p></li><li 
class="li"><p><code>KAUTH VNODE NOIMMUTABLE«/code» — This is a 
special flag. It is passed to the listener along with the 
<code>KAUTH VNODE WRITE SECURITY</code> bit (and no others) to indicate 
that the actor wishes to change one or more of the immutable flags, and that the 
state of these flags should not be considered when authorizing the 

request. </p></li></ul><section><a name="//apple ref/doc/uid/DTS10003591- 
CH1-SUBSUBSECTION11" title="Vnode Scope Gotchas"></a><h4 
class="jump">Vnode Scope Gotchas</h4><p>Remember that actions within 
the vnode scope are a bitfield. Thus a vnode scope listener can be called to 
authorize multiple actions simultaneously.</p><p>The vnode scope is 
<strong>extremely hot</strong>. If your vnode scope listener is slow, it will 
significantly slow down all file system operations. If you install a vnode scope 
listener, you should work to make it as efficient as possible.</p><p>When 
writing a vnode scope listener, be aware that not every file system operation will 
trigger an authorization request. For example, if an actor successfully requests 
<code>KAUTH VNODE SEARCH</code> on a directory, the system may cache 
that result and grant future requests without invoking your listener for each 
one.</p><p>For more information about the pitfalls of writing a listener, see 
<span class="content_text"><!--a -->Listener 
Gotchas<!--/a--></span>.</p></section></section><div 
class="back to top"><a href="#top" 


onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
technotes/tn2127/_index.html#top_8&quot;;return this.s oc? 

this.s oc(e):true">Back to Top</a></div></section><section><a 
name="//apple ref/doc/uid/DTS10003591-CH1-SECTION14" title="Listener 
Gotchas"></a><h2 class="jump">Listener Gotchas</h2><p>When writing a 
listener, there are a number of important points that you need to keep in mind. 
These are discussed in the following sections.</p><section><a 

name="//apple ref/doc/uid/DTS10003591-CH1-SUBSECTION14" 
title="Context"></a><h3 class="jump">Context</h3><p>In most cases your 
listener will be called by the user's thread. That is, a user thread has made a 
system call, which caused it to enter the kernel to do the work, which has 
triggered a Kauth request. So, it's possible to get information about the actor 
based on the current thread or process. For example, you can call 
<code>proc_self</code> to get a reference to the current process and then 
extract useful information from that.</p><p>However, you should try to avoid 
doing this. Rather, your listener should make its decision based on the actor's 
credentials (as passed to it in the <code>credentials</code> parameter) and, if 
you're listening in the <span class="content_text"><!--a -->vnode scope<!--/a-- 
></span>, the VFS context.</p><p>There are two reasons for this 
recommendation. </p> <ul class="ul"><li class="li"><p>As far as the overall 
kernel design is concerned, it is cleaner for your listener to make decisions based 
on its input parameters, rather than on implicit parameters like the current 
thread. </p></li><li class="li"><p>In some cases, it's possible for a kernel 
operation to be executed by another thread on behalf of the user. This sort of 
thing already happens for asynchronous 1/0, where the kernel maintains a pool 
of async I/O threads that perform asynchronous file system requests. Currently 
these threads don't actually make authorization requests, but the long-term 
direction is clear.</p></li></ul><section><a 
name="//apple_ref/doc/uid/DTS10003591-CH1-SUBSUBSECTION14" 
title="Deadlock Avoidance"></a><h4 class="jump">Deadlock 
Avoidance</h4><p>Your listener is called by the thread that's performing the 
operation, so it's possible to block the thread while you process the request. 
However, this is a two-edged sword. It allows your listener to pass the request to 
an external agent (a user space daemon, for example) and block waiting for the 
results. However, doing so entails significant risk of deadlocking the 
system.</p><p>This problem most commonly crops up when writing a listener 
for the <span class="content_text"><!--a -->vnode<!--/a--></span> or <span 
class="content_text"><!--a -->file operation<!--/a--></span> scopes. A typical 


example is:</p><ol class="ol"><li class="li"><p>You install a listener for the 
<span class="content text"><!--a -->file operation<!--/a--></span> 
scope. </p></li><li class="li"><p>A normal process opens a file.</p></li><li 


class="li"><p>Your listener is called with <code>KAUTH FILEOP OPEN</code>. 
It passes the request to a user space daemon and waits for the 
result.</p></li><li class="li"><p>The user space daemon calls some system 
routine that RPCs to a system daemon. For example, it might call <span 
class="content_text"><a href="x-man-page://3/getpwuid" class="urlLink" 
rel="external" 
onclick="s_objectID=&quot;x-man-page://3/getpwuid_1&quot;;return this.s oc? 
this.s_oc(e):true">getpwuid</a></span>, which is actually implemented inside 
<span class="content_text"><a href="x-man-page://8/lookupd" class="urlLink" 
rel="external" 
onclick="s_objectID=&quot;x-man-page://8/lookupd_1&quot;;return this.s oc? 
this.s_oc(e):true">lookupd</a></span>.</p></li><li class="li"><p>The 
system daemon opens a file.</p></li><li class="li"><p>This causes the kernel 


to call your listener, and the cycle starts over again.</p></li></ol><p>This 
problem is much worse than it seems. Specifically:</p><ul class="ul"><li 
class="li"><p>System daemons call other system daemons. For example, 
<code>lookupd</code> is dependent on <span class="content_text"><a 
href="x-man-page://8/DirectoryService" class="urlLink" rel="external" 
onclick="s_objectID=&quot;x-man-page://8/DirectoryService_1&quot;;return 
this.s_oc?this.s_oc(e):true">DirectoryService</a></span>, which may in turn be 
dependent on other daemons.</p></li><li class="li"><p>You can't just hard- 
code a list of possible system daemons because the dependency tree varies of 
from release-to-release; Apple can add new dependencies at any 
time.</p></li><li class="li"><p>It's impossible for your daemon to not depend 
on any system daemons. Every time you touch pageable memory, you might 
trigger the allocation of a paging file, which depends on the <span 
class="content_text"><a href="x-man-page://8/dynamic pager" class="urlLink" 
rel="external" 
onclick="s_objectID=&quot;x-man-page://8/dynamic_pager_1&quot;;return 
this.s oc?this.s oc(e):true">dynamic pager</a></span>.</p></li></ul><p>Th 
ere are a variety of ways to avoid this deadlock. The best is for your listener to 
avoid do any processing if the request comes from a thread running as root (that 
is, where <code>kauth cred getuid</code> for the actor's credentials returns 
0). As all critical system daemons will necessarily run as root, you break the 
deadlock at step 6 above.</p><div class="notebox"><aside><a 
name="//apple ref/doc/uid/DTS10003591-CH1-DontLinkElementID 12" 
title="Note"></a><p><strong>Note:</strong>&nbsp;The group resolution 
membership daemon, <span class="content_text"><a 
href="x-man-page://8/memberd" class="urlLink" rel="external" 
onclick="s_objectID=&quot;x-man-page://8/memberd_1&quot;;return this.s oc? 
this.s_oc(e):true">memberd</a></span>, faces a similar problem, and it avoids 
this problem in exactly this fashion; the system never invokes 
<code>memberd</code> if the thread is running as 
root.</p><p></p></aside></div><p>However, this technique may not be 
appropriate in all cases. For example, an <span class="content_text"><!--a -- 
>anti-virus scanner<!--/a--></span> would particularly want to scan files being 
opened by a thread running with elevated privileges. In this case the only correct 
solution is for the scanner to operate entirely within the 
kernel.</p></section><section><a name="//apple_ref/doc/uid/DTS10003591- 
CH1-SUBSUBSECTION15" title="Performance"></a><h4 
class="jump">Performance</h4><p>Some Kauth scopes are very hot. That is, 
a typical system will make authorization requests in that scope frequently. For 
example, a system copying files might make thousands of <span 
class="content_text"><!--a -->vnode scope<!--/a--></span> authorization 
requests per second. If you register a listener for a scope, it can be called for 
every request. If your listener is slow, it will significantly degrade system 
performance.</p><p>The two hot scopes on Mac OS X are the <span 
class="content text"»«!--a -->vnode scope<!--/a--></span> and the <span 
class="content_text"><!--a -->file operation scope<!--/a--></span>. If you 
install a listener for either of these scopes, be sure to measure the effect your 
listener has on overall system performance, and optimize your listener 
accordingly.</p></section></section><div class="back to top"><a 
href="#top" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
technotes/tn2127/_index.html#top_9&quot;;return this.s oc? 
this.s_oc(e):true">Back to Topx/a» «/div» «/section» «section» «a 
name="//apple ref/doc/uid/DTS10003591-CH1-SECTION18" title="Kauth 


Cookbook"></a><h2 class="jump">Kauth Cookbook</h2><p>This section 
describes how to use Kauth to implement some commonly requested 
features.</p><section><a name="//apple ref/doc/uid/DTS10003591-CH1- 
SUBSECTION18" title="Denying the Debugger"></a><h3 
class="jump">Denying the Debugger</h3><p>You can use Kauth to implement 
a kernel extension that prevents users attaching to processes with the debugger. 
All you need to do is register a listener for the 
<code>KAUTH SCOPE PROCESS</code> scope and look for the 
<code>KAUTH PROCESS CANTRACE</code> action. <span 
class="content text"><!--a -->Listing 11<!--/a--></span> shows an example 
listener that denies debugging for everyone except root. You can use a similar 
technique to prevent the debugger attaching to specific processes.</p><a 
name="//apple ref/doc/uid/DTS10003591-CH1-SOURCECODELL" title="Listing 
11Denying the debugger"></a><p class="codesample clear"><strong 
class="caption_number">Listing 11</strong>&nbsp;&nbsp;Denying the 
debugger</p><div class="codesample clear"><table><tbody><tr> <td 
scope="row"><pre>static int KauthDenyDebugListener( 

kauth cred t credential, 

void * idata, 

kauth_action_t action, 

uintptr_t argo, 

uintptr_t argl, 

uintptr_t arg2, 

uintptr_t arg3 


// We register this listener for the KAUTH SCOPE PROCESS scope. 
// The system calls this listener whenever it needs to authorize 

// an action within that scope. We look for 

// KAUTH PROCESS CANTRACE action and deny it if the requesting 
// user is not root. 


int result; 
result = KAUTH_RESULT_DEFER; 


switch (action) { 
case KAUTH_PROCESS_CANTRACE: 
{ 
proc_t targetProc; 
int errPtr; 


targetProc = (proc t) argo; 
errPtr = (int *) arg]; 


if (kauth_cred_getuid(credential) != 0) { 
printf( 
"Denied P_TRACE from %d to %d by %d.\n", 
proc_selfpid(), 
proc_pid(targetProc), 
kauth_cred_getuid(credential) 
); 
*errPtr = EPERM; 
result = KAUTH_RESULT_DENY; 
} 


} 

break; 
default: 

// do nothing 

break; 


} 


return result; 
}<span></span></pre></td></tr></tbody></table></div><div 
class="notebox"><aside><a name="//apple_ref/doc/uid/DTS10003591-CH1- 
DontLinkElementID 13" 
title="Note"></a><p><strong>Note:</strong>&nbsp;Kauth is not invoked 
when a program is started by the debugger. You can detect this case using the 
technique shown in <span class="content text"><a 
href="/qa/qa2004/qa1361.html" class="urlLink" rel="external" 
onclick="s_objectID=&quot;https://developer.apple.com/qa/qa2004/qa1361.html 
_1&quot;;return this.s_oc?this.s_oc(e):true">Technical Q&amp;A QA1361, 
‘Detecting the 
Debugger'</a></span>.</p><p></p></aside></div></section><section><a 
name="//apple_ref/doc/uid/DTS10003591-CH1-SUBSECTION19" title="Anti-Virus 
Scanner"></a><h3 class="jump">Anti-Virus Scanner</h3><p>Kauth allows 
you to implement an anti-virus program that supports both "on access" and "post 
modification" file scanning. The latter is easy: all you need to do is register a 
listener for the «code»KAUTH SCOPE FILEOP</code> scope and watch for the 
<code>KAUTH_FILEOP_CLOSE</code> action. If you see a modified file being 
closed, you can pass that file to your user space daemon for scanning. As the 
scanning proceeds asynchronously in the background, there should be no 
problems with deadlock.</p><p>Implementing "on access" scanning is more 
challenging. Your approach depends on whether you can always fix a file. If 
that's the case, you can listen for <code>KAUTH_FILEOP_OPEN</code> (in the 
<code>KAUTH SCOPE FILEOP</code>) and scan the file immediately after it's 
been opened. However, the result of your listener is always ignored, so there is 
no way to deny the actor access to that file.</p><p>If you can't always fix a file, 
and thus you may want to deny the actor access to the file, you must listen for 
the appropriate actions in the <code>KAUTH_SCOPE_VNODE</code> scope. If 
you scan a file, detect that it's infected, and can't fix it, you should return 
<code>KAUTH_RESULT_DENY</code> to prevent the actor from using 
it.</p><p>The difficulty with both of these "on access" approaches is avoiding 
deadlock. See <span class="content_text"><!--a -->Implementing a 
Listener<!--/a--></span> for a detailed discussion of this 
problem.</p></section><section><a 
name="//apple ref/doc/uid/DTS10003591-CH1-SUBSECTION20" title="New 
Kernel Subsystem"></a><h3 class="jump">New Kernel Subsystem</h3><p>lf 
you're implementing an entirely new kernel subsystem (for example, a 
sophisticated protocol stack), you may decide to implement your authorization 
using Kauth. There are seven steps to this:</p><ol class="ol"><li 
class="li"><p>Decide on a scope name. You should use a reverse DNS-style 
name, as illustrated by the built-in scopes <span class="content text"><!--a -- 
>described in this document<!--/a--></span>.</p></li><li 
class="li"><p>Decide on a set of actions. You can choose to use either an 
enumeration (as done by the <span class="content_text"><!--a -->file 
operations scope<!--/a--></span>) or a bitmask (as used by the <span 
class="content_text"><!--a -->vnode scope<!--/a--></span>).</p></li><li 
class="li"><p>For each action, you must decide what request-specific 


arguments (of type <code>arg0</code> through <code>arg3</code>) are 
appropriate for that action. It's easiest if the arguments are the same for all of 
the actions within your scope, but that's not required.</p></li><li 
class="li"><p><span class="content text"»«!--a -->Write a default 
listener<!--/a--></span> for your scope. This listener should be able to make 
authorization decisions based on:</p><ul class="ul"><li class="li"><p>the 
identity of the actor (as represented by the listener's <code>credentials</code> 
parameter)</p></li><li class="li"><p>the requested action</p></li><li 
class="li"><p>the request-specific arguments</p></li></ul><p>Your listener 
can extract information from the credentials using the accessor functions defined 
in &lt;sys/kauth.h&gt;.</p></li><li class="li"><p>Create your scope, and 
register your listener as the default listener, using 
<code>kauth register scope</code>.</p></li><li class="li"><p>Create a 
scope-specific wrapper function for <code>kauth_authorize_action</code> 
that:</p><ul class="ul"><li class="li"><p>supplies a reference to the scope 
created in the previous step</p></li><li class="li"><p>casts your scope- 
specific arguments to the generic arguments (<code>arg0</code> through 
<code>arg3</code>) used by 
<code>kauth_authorize_action</code></p></li></ul></li><li 
class="li"><p>Call your scope-specific wrapper function to authorize specific 
actions at appropriate places in your kernel 

subsystem. </p></li></ol></section><div class="back to top"><a 
href="#top" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
technotes/tn2127/_index.html#top_10&quot;;return this.s oc? 
this.s_oc(e):true">Back to Top</a></div></section><section><a 
name="//apple_ref/doc/uid/DTS10003591-CH1-SECTION22" title="KauthORama 
Sample Code"></a><h2 class="jump">KauthORama Sample 
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onclick="s objectID=&quot;https://developer.apple.com/samplecode/KauthORa 
ma/index.html_1&quot;;return this.s_oc?this.s_oc(e):true">Sample Code 
'KauthORama'</a></span> is a great tool for exploring Kauth. It allows you to 
register a dummy listener for any scope. The listener always returns 
<code>KAUTH RESULT DEFER«/code», and so has no effect on authorization 
decisions, but it prints a record of the authorization request. Using this you can 
see how Kauth interacts with high-level operations, like listing directories or 
copying files. The sample's read me file has instructions for doing this.</p><div 
class="back to top"><a href="#top" 
onclick="s_objectID=&quot;https://developer.apple.com/library/archive/ 
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class="ac-gn-searchresults-link ac-gn-searchresults-link-defaultlinks">What's 
included in Xcode</a></li><li class="ac-gn-searchresults-item ac-gn- 
searchresults-animated"><a 
href="https://developer.apple.com/videos/play/wwdc2022/110345/" id="search- 
group-link-4" class="ac-gn-searchresults-link ac-gn-searchresults-link- 
defaultlinks">What’s new in Endpoint Security</a></li></ul> 
<span role="status" class="ac-gn-searchresults-count" aria- 
live="polite">5 Quick Links</span> 
</div> 
</section> 
</aside> 
</div> 
<button id="ac-gn-searchview-close" class="ac-gn- 
searchview-close" aria-label="Cancel Search"> 
<span class="ac-gn-searchview-close- 
wrapper"> 
<span class="ac-gn-searchview-close- 
left"></span> 
<span class="ac-gn-searchview-close- 
right"></span> 
</span> 
</button> 
</aside> 
</div> 
</nav> 
<div class="ac-gn-blur"></div> 
<div id="ac-gn-curtain" class="ac-gn-curtain"></div> 
<div id="ac-gn-placeholder" class="ac-nav-placeholder"></div> 
<script src="/assets/scripts/ac-globalnav.built.js?41172203193"></script><div 
id="ac-gn-viewport-emitter"> </div> 


<link rel="stylesheet" href="/assets/styles/search.css?41172203193"> 
<script src="/assets/scripts/search.js?41172203193"></script> 


<!-- metrics --> 
<script> 
/* RSID: */ 
var s account="awdappledeveloper" 
</script> 
<script src="/assets/metrics/scripts/analytics.js?10202020"></script> 
<script> 
s.pageName= AC && AC.Tracking && AC.Tracking.pageName(); 
s.channel="www.en.developer" 
s.channel="www.en.developer"; 


peopepopocoraxx DO NOT ALTER ANYTHING BELOW THIS LINE ! Ferrer / 
var s code=s.t();if(s code)document.write(s code) 

</script> 

<!-- /metrics --> 


<link rel="stylesheet" property="stylesheet" 
href="/assets/styles/localnav.css" type="text/css"> 
<input type="checkbox" id="localnav-menustate" class="localnav-menustate"> 
<div id="localnav-sticky-placeholder" class="css-sticky 
localnav-sticking"></div><nav id="localnav" class="localnav localnav-scrim 
css-sticky localnav-sticking" data-sticky="" role="navigation"> 
<div class="localnav-wrapper"> 
<div class="localnav-background"></div> 
<div class="localnav-content"> 
<h2 class="localnav-title"> 
<a href="/augmented-reality/">Augmented Reality</a> 
</h2> 


<div class="localnav-menu"> 
<a href="#localnav-menustate" class="localnav-menucta-anchor 
localnav-menucta-anchor-open" id="localnav-menustate-open"> 
<span class="localnav-menucta-anchor-label">Open Menu</span> 
</a> 
<a href="#" class="localnav-menucta-anchor localnav-menucta- 
anchor-close" id="localnav-menustate-close"> 
<span class="localnav-menucta-anchor-label">Close Menu</span> 
</a> 
<div class="localnav-menu-tray"> 
<ul class="localnav-menu-items"> 
<li class="localnav-menu-item"> 
<a href="/augmented-reality/" class="localnav-menu-link 
current" aria-disabled="true">Overview</a> 
</li> 
<li class="localnav-menu-item"> 
<a href="/augmented-reality/arkit/" class="localnav-menu- 
link">ARKit</a> 
</li> 
<li class="localnav-menu-item"> 


<a href="/augmented-reality/realitykit/" class="localnav-menu- 
link">RealityKit</a> 
</li> 
<li class="localnav-menu-item"> 
<a href="/augmented-reality/roomplan/" class="localnav- 
menu-link">RoomPlan</a> 
</li> 
<li class="localnav-menu-item"> 
<a href="/augmented-reality/tools/" class="localnav-menu- 
link">AR Creation Tools</a> 
</li> 
<li class="localnav-menu-item"> 
<a href="/augmented-reality/quick-look/" class="localnav- 
menu-link">AR Quick Look</a> 
</li> 
<li class="localnav-menu-item"> 
<a href="/augmented-reality/resources/" class="localnav- 
menu-link">Resources</a> 
</li> 
</ul> 
</div> 
<div class="localnav-actions localnav-actions"> 
<div class="localnav-action localnav-action-menucta" aria- 
hidden="true"> 
<label for="localnav-menustate" class="localnav-menucta"> 
<span class="localnav-menucta-chevron"></span> 
</label> 
</div> 
</div> 
</div> 
</div> 
</div> 
</nav> 
<label id="localnav-curtain" for="localnav-menustate"></label> 
<script src="/assets/scripts/ac-localnav.built.js"></script><div id="localnav- 
viewport-emitter" data-viewport-emitter-dispatch="" data-viewport-emitter- 
state="{&quot;viewport&quot;:&quot;small&quot;,&quot;orientation&quot;:&quo 
t;portrait&quot;,&quot;retina&quot;:true}"></div> 
<script type="text/javascript" src="/assets/scripts/localnav.js"></script> 


<main id="main" class="main" role="main"> 


<section class="section section-hero bg-yellow" data-hires- 
status="pending"> 
<div class="section-content"> 
<div class="row"> 
<div class="column large-centered large-10 

small-12 text-center"> 

<figure class="arkit-glyph center" data- 
hires-status="pending"></figure> 

<hl class="typography-headline">Dive 
into the world of augmented&nbsp;reality.</h1> 


<p class="typography-intro">Build 
unparalleled augmented reality experiences for hundreds of millions of users on 
iOS and iPadOS, the biggest AR platforms in the world. With powerful frameworks 
like ARKit and RealityKit, and creative tools like <span class="nowrap">Reality 
Composer</span> and <span class="nowrap">Reality Converter,</span> it’s 
never been easier to bring your ideas to life in&nbsp;AR.</p> 
</div> 
</div> 

</div> 

<figure class="lockup-hero center" data-hires- 
status="pending"></figure> 

</section> 


<section class="section section-realitykit2 theme-dark"> 
<div class="section-content"> 
<div class="row"> 
<div class="column large-6 small-12"> 

<h2>RealityKit</h2> 

<p>RealityKit gives you more control and 
customization over the AR experiences you create. With APIs like Custom 
Rendering, Metal Shaders, and Post Processing, you have more control over the 
rendering pipeline and more flexibility to create entirely new worlds in AR. And 
with the Object Capture API, you can create unique 3D objects that are optimized 
for AR in minutes using state-of-the-art photogrammetry algorithms.</p> 


<p><a 
href="/augmented-reality/realitykit/" class="more">Learn more</a></p> 
</div> 


<div class="column large-6 small-12"> 
<figure class="icon-reality-kit" data-hires- 
status="pending"></figure> 
</div> 
</div> 
</div> 
</section> 


<section class="section section-realitykit bg-light"> 
<div class="section-content"> 
<div class="row"> 
<div class="column large-centered large-8 
small-12 text-center"> 


<h2>AR creation tools</h2> 
<p>Reality Composer is a powerful tool 
that makes it easy for you to create interactive augmented reality experiences 
with no prior 3D experience. <span class="nowrap">Reality Converter</span> 
quickly converts your existing 3D models to USDZ so it works seamlessly in our 
tools and on all AR-enabled iPhone and iPad devices.</p> 
<p><a href="/augmented-reality/tools/" 
class="more">Learn more</a></p> 
</div> 
</div> 
</div> 
<figure class="creation-image device-macbook-pro-space- 
grey center" data-hires-status="pending" style="background-image: 


url(&quot;https://developer.apple.com/assets/elements/hardware/macbook_pro_s 
pace grey/small_2x.png?156454&quot;);"> 
<figure class="device-screen screen-creation" data- 
hires-status="pending"></figure> 
</figure> 
</section> 


<section class="section section-gallery"> 
<div class="section-content"> 
<div class="row"> 
<div class="column large-centered large-7 
medium-10 small-12 text-center"> 
<h2 class="typography-subsection- 
headline">AR Quick Look</h2> 
<p>Place 3D objects in the real world 
using <span class="nowrap">AR Quick Look,</span> powered by ARKit. <span 
class="nowrap">AR Quick Look</span> also supports models and scenes 
created in <span class="nowrap">Reality Composer,</span> so you can easily 
create interactive experiences to be shared and viewed on iPhone 
and&nbsp;iPad.</p> 
<p><a href="/augmented-reality/quick- 
look/" class="more">View the Quick Look Gallery</a></p> 
</div> 
</div> 
<div class="row row-models"> 
<div class="column large-centered large-11 
medium-12"> 
<div class="row"> 
<div class="column large-3 text- 
center"> 
<figure class="image-model 
model-drummertoy" data-hires-status="pending"></figure> 
</div> 
<div class="column large-3 text- 
center"> 
<figure class="image-model 
model-biplane" data-hires-status="pending"></figure> 
</div> 
<div class="column large-3 text- 
center"> 
<figure class="image-model 
model-vintagerobot2k" data-hires-status="pending"></figure> 
</div> 
<div class="column large-3 text- 
center"> 
<figure class="image-model 
model-toycar" data-hires-status="pending"></figure> 
</div> 
</div> 
</div> 
</div> 
</div> 
</section> 


<section class="section section-new bg-blue-gradient-alt" data- 
hires-status="pending"> 
<div class="section-content"> 
<div class="row"> 
<div class="large-centered large-7 small-12 
text-center"> 
<figure class="icon-app-store center" 
data-hires-status="pending"></figure> 
<h2>AR on the <span 
class="nowrap">App Store</span></h2> 
<p>Discover the unique apps and games 
that other developers have created with ARKit. If you’re creating an amazing 
experience with ARKit and would like to share it with us, <a 
href="/contact/arkit/" class="nowrap">let us know</a>.</p> 
<p><a 
href="https://apps.apple.com/story/id1288297581">View on the <span 
class="more nowrap">App Store</span></a></p> 
</div> 
</div> 
</div> 
</section> 


<section class="section section-resources bg-light"> 
<div class="section-content"> 
<div class="row"> 
<div class="column large-centered large-7 

medium-9 small-12 text-center"> 

<figure class="router-icon-service center" 
data-hires-status="pending"></figure> 

<h2>Resources</h2> 

<p>Find the tools and documentation you 
need to create AR experiences.</p> 


<p><a 
href="/augmented-reality/resources/" class="more">View resources</a></p> 
</div> 
</div> 
</div> 
</section> 
</main> 


<link rel="stylesheet" href="/assets/styles/footer.dist.css? 
41172203193"> 
<footer id="footer" class="footer" role="contentinfo" aria-labelledby="footer- 
label"> 
<div class="footer-content"> 
<h2 class="footer-label" id="footer-label">Developer Footer</h2> 
<developer-breadcrumbs style="display: block;"> 


<nav class="footer-breadcrumbs" aria-label="Breadcrumbs"><a 
href="https://www.apple.com/" class="home footer-breadcrumbs-home"><span 
class="footer-breadcrumbs-home-icon" aria-hidden="true" data-hires- 


status="pending">[]</span><span class="footer-breadcrumbs-home- 
label">Apple</span></a><div class="footer-breadcrumbs-path"><ol 
class="footer-breadcrumbs-list"><li class="footer-breadcrumbs-item"><a 
href="/">Developer</a></li><li class="footer-breadcrumbs-item">Augmented 
Reality </li></ol></div></nav></developer-breadcrumbs> 
<nav class="footer-directory" aria-label="Apple Developer Directory" 
role="navigation"> 
<!--googleoff: all--> 
<div class="footer-directory-column"> 
<input class="footer-directory-column-section-state" 
type="checkbox" id="footer-directory-column-section-state-platform"> 
<div class="footer-directory-column-section"> 
<label class="footer-directory-column-section-label" 
for="footer-directory-column-section-state-platform"> 
<h3 class="footer-directory-column-section- 
title">Platforms</h3> 
</label> 
<a href="#footer-directory-column-section-state-platform" 
class="footer-directory-column-section-anchor footer-directory-column-section- 
anchor-open"> <span class="footer-directory-column-section-anchor- 
label">Open Menu</span> </a> 
<a href="#" class="footer-directory-column-section-anchor 
footer-directory-column-section-anchor-close"> <span class="footer-directory- 
column-section-anchor-label">Close Menu</span> </a> 
<ul class="footer-directory-column-section-list"> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/ios/">iOS</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/ipados/">iPadOS</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/macos/">macOS</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/tvos/">tvOS</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="/watchos/">watchOS</a></li> 
</ul> 
</div> 


<input class="footer-directory-column-section-state" 
type="checkbox" id="footer-directory-column-section-state-tools"> 
<div class="footer-directory-column-section"> 
<label class="footer-directory-column-section-label" 
for="footer-directory-column-section-state-tools"> 
<h3 class="footer-directory-column-section- 
title">Tools</h3> 
</label> 
<a href="#footer-directory-column-section-state-tools" 
class="footer-directory-column-section-anchor footer-directory-column-section- 
anchor-open"> <span class="footer-directory-column-section-anchor- 
label">Open Menu</span> </a> 
<a href="#" class="footer-directory-column-section-anchor 
footer-directory-column-section-anchor-close"> <span class="footer-directory- 
column-section-anchor-label">Close Menu</span> </a> 


<ul class="footer-directory-column-section-list"> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/swift/">Swift</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/swiftui/">SwiftUl</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/swift-playgrounds/">Swift 
Playgrounds</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="/testflight/">TestFlight</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/xcode/">Xcode</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/xcode-cloud/">Xcode 
Cloud</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/sf-symbols/">SF 
Symbols</a></li> 

</ul> 
</div> 
</div> 


<div class="footer-directory-column"> 
<input class="footer-directory-column-section-state" 
type="checkbox" id="footer-directory-column-section-state-topics"> 
<div class="footer-directory-column-section"> 
<label class="footer-directory-column-section-label" 
for="footer-directory-column-section-state-topics"> 
<h3 class="footer-directory-column-section- 
title">Topics &amp; Technologies</h3> 
</label> 
<a href="#footer-directory-column-section-state-topics" 
class="footer-directory-column-section-anchor footer-directory-column-section- 
anchor-open"> <span class="footer-directory-column-section-anchor- 
label">Open Menu</span> </a> 
<a href="#" class="footer-directory-column-section-anchor 
footer-directory-column-section-anchor-close"> <span class="footer-directory- 
column-section-anchor-label">Close Menu</span> </a> 
<ul class="footer-directory-column-section-list"> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="/accessibility/">Accessibility</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="/accessories/">Accessories</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/app-extensions/">App 
Extensions</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/app-store/">App 
Store</a></li> 


«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/audio/">Audio &amp; 
Video</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/augmented- 
reality/">Augmented Reality</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="/business/">Business</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/design/">Design</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="/distribute/">Distribution</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="/education/">Education</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/fonts/">Fonts</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/games/">Games</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/health-fitness/">Health 
&amp; Fitness</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/in-app-purchase/">In-App 
Purchase</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="/localization/">Localization</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/maps/">Maps &amp; 
Location</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/machine-learning/">Machine 
Learning</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="/security/">Security</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/safari/">Safari &amp; 
Web</a></li> 

</ul> 
</div> 
</div> 


<div class="footer-directory-column"> 

<input class="footer-directory-column-section-state" 
type="checkbox" id="footer-directory-column-section-state-resources"> 

<div class="footer-directory-column-section"> 

<label class="footer-directory-column-section-label" 
for="footer-directory-column-section-state-resources"> 
<h3 class="footer-directory-column-section- 

title">Resources</h3> 


</label> 
<a href="#footer-directory-column-section-state-resources" 
class="footer-directory-column-section-anchor footer-directory-column-section- 
anchor-open"> <span class="footer-directory-column-section-anchor- 
label">Open Menu</span> </a> 
<a href="#" class="footer-directory-column-section-anchor 
footer-directory-column-section-anchor-close"> <span class="footer-directory- 
column-section-anchor-label">Close Menu</span> </a> 
<ul class="footer-directory-column-section-list"> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="/documentation/">Documentation</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="/learn/curriculum/">Curriculum</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="/download/">Downloads</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="https://developer.apple.com/forums/">Forums</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/videos/">Videos</a></li> 
</ul> 
</div> 


<input class="footer-directory-column-section-state" 
type="checkbox" id="footer-directory-column-section-state-support"> 
<div class="footer-directory-column-section"> 
<label class="footer-directory-column-section-label" 
for="footer-directory-column-section-state-support"> 
<h3 class="footer-directory-column-section- 
title">Support</h3> 
</label> 
<a href="#footer-directory-column-section-state-support" 
class="footer-directory-column-section-anchor footer-directory-column-section- 
anchor-open"> <span class="footer-directory-column-section-anchor- 
label">Open Menu</span> </a> 
<a href="#" class="footer-directory-column-section-anchor 
footer-directory-column-section-anchor-close"> <span class="footer-directory- 
column-section-anchor-label">Close Menu</span> </a> 
<ul class="footer-directory-column-section-list"> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/support/articles/">Support 
Articles</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/contact/">Contact 
Us</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/bug-reporting/">Bug 
Reporting</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/system-status/">System 
Status</a></li> 


</ul> 
</div> 


<input class="footer-directory-column-section-state" 
type="checkbox" id="footer-directory-column-section-state-account"> 
<div class="footer-directory-column-section"> 
<label class="footer-directory-column-section-label" 
for="footer-directory-column-section-state-account"> 
<h3 class="footer-directory-column-section- 
title" >Account</h3> 
</label> 
<a href="#footer-directory-column-section-state-account" 
class="footer-directory-column-section-anchor footer-directory-column-section- 
anchor-open"> <span class="footer-directory-column-section-anchor- 
label">Open Menu</span> </a> 
<a href="#" class="footer-directory-column-section-anchor 
footer-directory-column-section-anchor-close"> <span class="footer-directory- 
column-section-anchor-label">Close Menu</span> </a> 
<ul class="footer-directory-column-section-list"> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/account/">Apple 
Developer</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="https://appstoreconnect.apple.com/">App Store Connect</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="/account/ios/certificate/">Certificates, IDs, &amp; Profiles</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="https://feedbackassistant.apple.com/">Feedback Assistant</a></li> 
</ul> 
</div> 
</div> 


<div class="footer-directory-column"> 
<input class="footer-directory-column-section-state" 
type="checkbox" id="footer-directory-column-section-state-programs"> 
<div class="footer-directory-column-section"> 
<label class="footer-directory-column-section-label" 
for="footer-directory-column-section-state-programs"> 
<h3 class="footer-directory-column-section- 
title">Programs</h3> 
</label> 
<a href="#footer-directory-column-section-state-programs" 
class="footer-directory-column-section-anchor footer-directory-column-section- 
anchor-open"> <span class="footer-directory-column-section-anchor- 
label">Open Menu</span> </a> 
<a href="#" class="footer-directory-column-section-anchor 
footer-directory-column-section-anchor-close"> <span class="footer-directory- 
column-section-anchor-label">Close Menu</span> </a> 
<ul class="footer-directory-column-section-list"> 


«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/programs/">Apple Developer 
Program</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/programs/enterprise/">Apple 
Developer Enterprise Program</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/app-store/small-business- 
program/">App Store Small Business Program</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="https://mfi.apple.com/">MFi 
Program</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/programs/news- 
partner/">News Partner Program</a> </li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/programs/video- 
partner/">Video Partner Program</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/security-bounty/">Security 
Bounty Program</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/programs/security-research- 
device/">Security Research Device Program</a></li> 

</ul> 
</div> 


<input class="footer-directory-column-section-state" 
type="checkbox" id="footer-directory-column-section-state-events"> 
<div class="footer-directory-column-section"> 
<label class="footer-directory-column-section-label" 
for="footer-directory-column-section-state-events"> 
<h3 class="footer-directory-column-section- 
title">Events</h3> 
</label> 
<a href="#footer-directory-column-section-state-events" 
class="footer-directory-column-section-anchor footer-directory-column-section- 
anchor-open"> <span class="footer-directory-column-section-anchor- 
label">Open Menu</span> </a> 
<a href="#" class="footer-directory-column-section-anchor 
footer-directory-column-section-anchor-close"> <span class="footer-directory- 
column-section-anchor-label">Close Menu</span> </a> 
<ul class="footer-directory-column-section-list"> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/accelerator/">App 
Accelerators</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/app-store/app-store- 
awards/">App Store Awards</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/design/awards/">Apple 
Design Awards</a></li> 


«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="/learn/experts/#academies">Apple Developer Academies</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/entrepreneur- 
camp/">Entrepreneur Camp</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/tech-talks/">Tech 
Talks</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/wwdc/">WWDC</a></li> 


</ul> 
</div> 
</div> 
<!--googleon: all--> 
</nav> 


<section class="footer-mini" vocab="http://schema.org/" 
typeof="Organization"> 
<div class="footer-mini-news"> 
<div class="copy"> 
To view the latest developer news, visit <a 
href="/news/">News and Updates</a>. 
</div> 
<div class="content"> 
<div class="color-scheme-toggle" role="radiogroup" 
tabindex="0" aria-label="Select a color scheme preference"> 


<label data-color-scheme-option="light"> 
<input type="radio" value="light" 
autocomplete="off" 
onchange="window.setPreferredColorScheme(event.target.value)"> 
<div class="text">Light</div> 
</label> 
<label data-color-scheme-option="dark"> 
<input type="radio" value="dark" 
autocomplete="off" 
onchange="window.setPreferredColorScheme(event.target.value)"> 
<div class="text">Dark</div> 
</label> 
<label data-color-scheme-option="auto"> 
<input type="radio" value="auto" 
autocomplete="off" 


onchange="window.setPreferredColorScheme(event.target.value)"> 


<div class="text">Auto</div> 


</label> 


</div> 
<script async="" src="/assets/scripts/color-scheme- 
toggle.js"></script> 
</div> 
</div> 
<link rel="stylesheet" href="/assets/styles/language-dropdown.css? 
41172203193"> 
<div class="language-dropdown dropdown-container" data- 
lang="complete"> 
<select class="dropdown" aria-label="Language 
Dropdown"><option value="https://developer.apple.com/augmented- 
reality/">English</option><option 
value="https://developer.apple.com/cn/augmented-reality/"> ]Q00</option><opt 
ion value="https://developer.apple.com/jp/augmented-reality/">[]0 
I</option><option value="https://developer.apple.com/kr/augmented-reality/"> 
OO0</option></select> 
<span class="dropdown-icon icon icon-chevrondown" aria- 
hidden="true"></span> 
</div> 
<script async="" src="/assets/scripts/lib/jquery/jquery.language- 
dropdown.js?41172203193"></script> 
<div class="footer-mini-legal"> 
<div class="footer-mini-legal-copyright">Copyright © 2022 <a 
href="https://www.apple.com">Apple Inc.</a> All rights reserved.</div> 
<div class="footer-mini-legal-links"> 
<a class="footer-mini-legal-link" 
href="https://www.apple.com/legal/internet-services/terms/site.html">Terms of 
Use</a> 


<a class="footer-mini-legal-link" 
href="https://www.apple.com/legal/privacy/en-ww/">Privacy Policy</a> 
<a class="footer-mini-legal-link" 
href="/support/terms/">Agreements and Guidelines</a> 
</div> 
</div> 
</section> 
</div> 
</footer> 


</body></html> 


<html xmIns="https://www.w3.org/1999/xhtml" xml:lang="en" 
lang="en"><head> 

<link rel="stylesheet" href="https://www.apple.com/wss/fonts? 
family =SF+Prosamp;v=2" type="text/css"> 
<link rel="stylesheet" href="https://www.apple.com/wss/fonts? 
family =SF+Pro+Iconssamp;v=1" type="text/css"> 
<link rel="stylesheet" href="https://www.apple.com/wss/fonts? 
family=SF+Mono&amp;v=2" type="text/css"> 
<link rel="stylesheet" href="https://www.apple.com/wss/fonts? 
family=Apple+lcons&amp;v=1" type="text/css"> 


<meta charset="utf-8"> 
<meta name="Author" content="Apple Inc."> 
<meta name="viewport" content="width=device-width, initial-scale=1, 
viewport-fit=cover"> 
<link rel="shortcut icon" href="/favicon.ico"> 
<link rel="icon" href="/favicon.ico"> 
<link rel="mask-icon" href="/apple-logo.svg" color="#333333"> 


<link rel="stylesheet" href="/assets/styles/global.dist.css?41172203193" 
type="text/css"> 


<link rel="stylesheet" href="/assets/styles/localization.css?41172203193" 
type="text/css"> 


<script src="/assets/scripts/lib/jquery/jquery-3.6.0.min.js?41172203193"></ 
script> 

<script src="/assets/scripts/settings.js?41172203193"></script> 

<script src="/assets/scripts/language-locales.js?41172203193"></script> 
<script src="/assets/scripts/DeveloperBreadcrumbs.js?41172203193"></script> 


<script async="" src="/assets/scripts/lib/jquery/jquery.retinate.js? 
41172203193"></script> 

<script async="" src="/assets/scripts/global.js?41172203193"></script> 
<script async="" src="/assets/scripts/global-logout.js?41172203193"></script> 


<title>RealityKit Overview - Augmented Reality - Apple Developer</title> 

<meta name="omni_page" content="RealityKit - Augmented Reality - 
(English)"> 

<meta name="Description" content="Use the Reality Composer app and 
RealityKit to build animations and interactions in iOS and macOS to enrich your 
3D content."> 


<meta property="og:locale" content="en_US"> 

<meta property="og:site_name" content="Apple Developer"> 

<meta property="og:type" content="website"> 

<meta property="og:image" 
content="https://developer.apple.com/news/images/og/realitykit-og.jpg"> 

<meta property="og:title" content="RealityKit Overview - Augmented 
Reality - Apple Developer"> 

<meta property="og:description" content="Use the Reality Composer app 
and RealityKit to build animations and interactions in iOS and macOS to enrich 
your 3D content."> 

<meta property="og:url" 
content="https://developer.apple.com/augmented-reality/realitykit/"> 


<meta name="twitter:card" content="summary_large_image"> 

<meta name="twitter:image" 
content="https://developer.apple.com/news/images/og/realitykit-og-twitter.jpg"> 

<meta name="twitter:description" content="Use the Reality Composer 
app and RealityKit to build animations and interactions in ¡OS and macOS to 
enrich your 3D content."> 

<meta name="twitter:title" content="RealityKit Overview - Augmented 
Reality - Apple Developer"> 


<meta name="twitter:url" 
content="https://developer.apple.com/augmented-reality/realitykit/"> 


<link rel="stylesheet" href="/augmented-reality/styles/augmented- 
reality.css" type="text/css"> 

<link rel="stylesheet" href="/augmented-reality/styles/realitykit-alt.css" 
type="text/css"> 


<link rel="alternate" href="https://developer.apple.com/augmented- 
reality/realitykit/" hreflang="en"> 

<link rel="alternate" href="https://developer.apple.com/cn/augmented- 
reality/realitykit/" hreflang="zh-CN"> 

<link rel="alternate" href="https://developer.apple.com/jp/augmented- 
reality/realitykit/" hreflang="ja-JP"> 

<link rel="alternate" href="https://developer.apple.com/kr/augmented- 
reality/realitykit/" hreflang="ko-KR"> 

<link rel="canonical" href="https://developer.apple.com/augmented- 
reality/realitykit/"> 
</head> 


<body id="reality-kit" class="dmf" data-color-scheme="light"> 


<link rel="stylesheet" href="/assets/styles/globalnav.css?41172203193" 
type="text/css"> 


<link rel="stylesheet" href="/assets/styles/suggest-lang.css?41172203193" 
type="text/css"> 
<div id="suggest-lang" class="ribbon hide"> 
<div class="ribbon-content-wrapper"> 
<div class="ribbon-content row"> 
<div class="column large-12 large-centered"> 
<a id="suggest-closer" class="icon icon-after icon- 
reset" ></a> 
<p><a href="#" id="suggest-link" class="ribbon-link 
more">View in English</a></p> 
</div> 
</div> 
</div> 
</div> 
<script src="/assets/scripts/suggest-lang.js?41172203193"></script> 
<aside id="ac-gn-segmentbar" class="ac-gn-segmentbar" lang="en-US" 
dir="ltr"> 
</aside> 
<input type="checkbox" id="ac-gn-menustate" class="ac-gn-menustate"> 
<nav id="ac-globalnav" class="js touch no-windows" role="navigation" aria- 
label="Global" data-hires="false" data-analytics-region="global nav" lang="en- 
US" dir="Itr" data-www-domain="www.apple.com" data-store-locale="us" data- 
store-root-path="/us" data-store-api="/[storefront]/shop/bag/status" data- 
search-locale="en_US" 
data-search-suggestions-api="/search-services/suggestions/" data-search- 
defaultlinks-api="/search-services/suggestions/defaultlinks/" data-search- 
suggestions-enabled="false"> 
<div class="ac-gn-content"> 
<ul class="ac-gn-header"> 


<li class="ac-gn-item ac-gn-menuicon"> 
<label class="ac-gn-menuicon-label" for="ac-gn- 
menustate" aria-hidden="true"> 
<span class="ac-gn-menuicon-bread ac-gn- 
menuicon-bread-top"> 
<span class="ac-gn-menuicon-bread- 
crust ac-gn-menuicon-bread-crust-top"></span> 
</span> 
<span class="ac-gn-menuicon-bread ac-gn- 
menuicon-bread-bottom"> 
<span class="ac-gn-menuicon-bread- 
crust ac-gn-menuicon-bread-crust-bottom"></span> 
</span> 
</label> 
<a href="#ac-gn-menustate" role="button" class="ac- 
gn-menuanchor ac-gn-menuanchor-open" id="ac-gn-menuanchor-open"> 
<span class="ac-gn-menuanchor-label">Global 
Nav Open Menu</span> 
</a> 
<a href="#" role="button" class="ac-gn-menuanchor 
ac-gn-menuanchor-close" id="ac-gn-menuanchor-close"> 
<span class="ac-gn-menuanchor-label">Global 
Nav Close Menu</span> 
</a> 
</li> 
<li class="ac-gn-item ac-gn-apple"> 
<a class="ac-gn-link ac-gn-link-apple-developer" 
href="/" data-analytics-title="appledeveloper home" id="ac-gn-firstfocus- 
small"> 
<span class="ac-gn-link-text">Apple 
Developer</span> 
</a> 
</li> 
</ul> 
<div class="ac-gn-search-placeholder-container" role="search"> 
<div class="ac-gn-search ac-gn-search-small"> 
<a id="ac-gn-link-search-small" class="ac-gn-link" 
href="/search/" data-analytics-title="search" data-analytics-click="search" data- 
analytics-intrapage-link="" aria-label="Search" role="button" aria- 
haspopup="true"> 
<div class="ac-gn-search-placeholder-bar"> 
<div class="ac-gn-search-placeholder- 
input"> 
<div class="ac-gn-search- 
placeholder-input-text" aria-hidden="true"> 
<div class="ac-gn-link- 
search ac-gn-search-placeholder-input-icon"></div> 
<span class="ac-gn-search- 
placeholder">Search</span> 
</div> 
</div> 
<div class="ac-gn-searchview-close ac- 
gn-searchview-close-small ac-gn-search-placeholder-searchview-close"> 


<span class="ac-gn-searchview- 
close-cancel" aria-hidden="true">Cancel</span> 
</div> 
</div> 
</a> 
</div> 
</div> 
<ul class="ac-gn-list"> 
<li class="ac-gn-item ac-gn-apple"> 
<a class="ac-gn-link ac-gn-link-apple-developer" 
href="/" data-analytics-title="appledeveloper home" id="ac-gn-firstfocus"> 
<span class="ac-gn-link-text">Apple 
Developer</span> 
</a> 
</li> 
<li class="ac-gn-item ac-gn-item-menu ac-gn-news"> 
<a class="ac-gn-link ac-gn-link-news" href="/news/" 
data-analytics-title="news"> 
<span class="ac-gn-link-text">News</span> 
</a> 
</li> 
<li class="ac-gn-item ac-gn-item-menu ac-gn-discover"> 
<a class="ac-gn-link ac-gn-link-discover" 
href="/discover/" data-analytics-title="discover"> 
<span 
class="ac-gn-link-text">Discover</span> 
</a> 
</li> 
<li class="ac-gn-item ac-gn-item-menu ac-gn-design"> 
<a class="ac-gn-link ac-gn-link-design" href="/design/" 
data-analytics-title="design"> 
<span class="ac-gn-link-text">Design</span> 
</a> 
</li> 
<li class="ac-gn-item ac-gn-item-menu ac-gn-develop"> 
<a class="ac-gn-link ac-gn-link-develop" 
href="/develop/" data-analytics-title="develop"> 
<span class="ac-gn-link-text">Develop</span> 
</a> 
</li> 
<li class="ac-gn-item ac-gn-item-menu ac-gn-distribute"> 
<a class="ac-gn-link ac-gn-link-distribute" 
href="/distribute/" data-analytics-title="distribute"> 
<span 
class="ac-gn-link-text">Distribute</span> 
</a> 
</li> 
<li class="ac-gn-item ac-gn-item-menu ac-gn-dsupport"> 
<a class="ac-gn-link ac-gn-link-dsupport" 
href="/support/" data-analytics-title="dsupport"> 
<span class="ac-gn-link-text">Support</span> 
</a> 
</li> 
<li class="ac-gn-item ac-gn-item-menu ac-gn-account"> 


<a class="ac-gn-link ac-gn-link-account" 
href="/account/" data-analytics-title="account"> 
<span class="ac-gn-link-text">Account</span> 
</a> 
</li> 
<li class="ac-gn-item ac-gn-item-menu ac-gn-search" 
role="search"> 
<a id="ac-gn-link-search" class="ac-gn-link ac-gn-link- 
search" href="/search/" data-analytics-title="search" data-analytics- 
click="search" data-analytics-intrapage-link="" aria-label="Search" 
role="button" aria-haspopup="true"></a> 
</li> 
</ul> 
<aside id="ac-gn-searchview" class="ac-gn-searchview" 
role="search" data-analytics-region="search"> 
<div class="ac-gn-searchview-content"> 
<div class="ac-gn-searchview-bar"> 
<div class="ac-gn-searchview-bar-wrapper"> 
<form id="ac-gn-searchform" class="ac- 
gn-searchform" action="/search/" method="get"> 
<div class="ac-gn-searchform- 
wrapper"> 
<input id="ac-gn- 
searchform-input" class="ac-gn-searchform-input" type="text" name="q" aria- 
label="Search" placeholder="Search" autocorrect="off" autocapitalize="off" 
autocomplete="off" spellcheck="false" role="combobox" aria- 
autocomplete="list" aria-expanded="true" aria-owns="quicklinks suggestions"> 
<button id="ac-gn- 
searchform-submit" class="ac-gn-searchform-submit" type="submit" 
disabled="" aria-label="Submit Search"></button> 
<button id="ac-gn- 
searchform-reset" class="ac-gn-searchform-reset" type="reset" disabled="" 
aria-label="Clear Search"> 


<span 
class="ac-gn-searchform-reset-background"></span> 
</button> 
</div> 
</form> 


<button id="ac-gn-searchview-close- 
small" class="ac-gn-searchview-close ac-gn-searchview-close-small" aria- 
label="Cancel Search"> 
<span class="ac-gn- 
searchview-close-cancel" aria-hidden="true"> 
Cancel 
</span> 
</button> 
</div> 
</div> 
<aside id="ac-gn-searchresults" class="ac-gn- 
searchresults" data-string-quicklinks="Quick Links" data-string- 
suggestions="Suggested Searches" data-string-noresults=""> 
<section class="ac-gn-searchresults-section ac-gn-searchresults- 
section-defaultlinks"> 
<div class="ac-gn-searchresults-section-wrapper"> 


<div class="search-group- 
checkbox hidden"><input id="group-input" type="checkbox" name="group- 
filter" checked="">Only search within “<span 
id="group-search-label"></span>"</div> 
<h3 class="ac-gn-searchresults-header ac-gn-searchresults- 
animated">Quick Links</h3> 
<ul class="ac-gn-searchresults-list" id="defaultlinks" 
role="listbox"> 
<li class="ac-gn-searchresults-item ac-gn-searchresults- 
animated"><a href="https://developer.apple.com/ios/" id="search-group-link-0" 
class="ac-gn-searchresults-link ac-gn-searchresults-link-defaultlinks">iOS 
16</a></li><li class="ac-gn-searchresults-item ac-gn-searchresults- 
animated"><a href="https://developer.apple.com/news/" id="search-group-link- 
1" class="ac-gn-searchresults-link ac-gn-searchresults-link-defaultlinks">Latest 
News</a></li><li class="ac-gn-searchresults-item ac-gn-searchresults- 
animated"><a 
href="https://developer.apple.com/documentation/storekit/appstore/ 
environment/3963900-xcode/" id="search-group-link-2" class="ac-gn- 
searchresults-link ac-gn-searchresults-link-defaultlinks">xcode</a></li><li 
class="ac-gn-searchresults-item ac-gn-searchresults-animated"><a 
href="https://developer.apple.com/xcode/whats-new/" id="search-group-link-3" 
class="ac-gn-searchresults-link ac-gn-searchresults-link-defaultlinks">What's 
included in Xcode</a></li><li class="ac-gn-searchresults-item ac-gn- 
searchresults-animated"><a 
href="https://developer.apple.com/videos/play/wwdc2022/110345/" id="search- 
group-link-4" class="ac-gn-searchresults-link ac-gn-searchresults-link- 
defaultlinks">What’s new in Endpoint Security</a></li></ul> 
<span role="status" class="ac-gn-searchresults-count" aria- 
live="polite">5 Quick Links</span> 
</div> 
</section> 
</aside> 
</div> 
<button id="ac-gn-searchview-close" class="ac-gn- 
searchview-close" aria-label="Cancel Search"> 
<span class="ac-gn-searchview-close- 
wrapper"> 
<span class="ac-gn-searchview-close- 
left"></span> 
<span class="ac-gn-searchview-close- 
right"></span> 
</span> 
</button> 
</aside> 
</div> 
</nav> 
<div class="ac-gn-blur"></div> 
<div id="ac-gn-curtain" class="ac-gn-curtain"></div> 
<div id="ac-gn-placeholder" class="ac-nav-placeholder"></div> 
<script src="/assets/scripts/ac-globalnav.built.js?41172203193"></script><div 
id="ac-gn-viewport-emitter"> </div> 
<link rel="stylesheet" href="/assets/styles/search.css?41172203193"> 
<script src="/assets/scripts/search.js?41172203193"></script> 


<!-- metrics --> 
<script> 
/* RSID: */ 
var s account="awdappledeveloper" 
</script> 
<script src="/assets/metrics/scripts/analytics.js?10202020"></script> 
<script> 
s.pageName= AC && AC.Tracking && AC.Tracking.pageName(); 
s.channel="www.en.developer" 
s.channel="www.en.developer"; 


peopepopocoraxx DO NOT ALTER ANYTHING BELOW THIS LINE ! *#**##4#444444/ 
var ss code=s.t();if(s code)document.write(s code) 

</script> 

<!-- /metrics --> 


<link rel="stylesheet" property="stylesheet" 
href="/assets/styles/localnav.css" type="text/css"> 
<input type="checkbox" id="localnav-menustate" class="localnav-menustate"> 
<div id="localnav-sticky-placeholder" class="css-sticky"></div><nav 
id="localnav" class="localnav localnav-scrim css-sticky" data-sticky="" 
role="navigation"> 
<div class="localnav-wrapper"> 
<div class="localnav-background"></div> 
<div class="localnav-content"> 
<h2 class="localnav-title"> 
<a href="/augmented-reality/">Augmented Reality</a> 
</h2> 


<div class="localnav-menu"> 
<a href="#localnav-menustate" class="localnav-menucta-anchor 
localnav-menucta-anchor-open" id="localnav-menustate-open"> 
<span class="localnav-menucta-anchor-label">Open Menu</span> 
</a> 
<a href="#" class="localnav-menucta-anchor localnav-menucta- 
anchor-close" id="localnav-menustate-close"> 
<span class="localnav-menucta-anchor-label">Close Menu</span> 
</a> 
<div class="localnav-menu-tray"> 
<ul class="localnav-menu-items"> 
<li class="localnav-menu-item"> 
<a href="/augmented-reality/" class="localnav-menu- 
link">Overview</a> 
</li> 
<li class="localnav-menu-item"> 
<a href="/augmented-reality/arkit/" class="localnav-menu- 
link">ARKit</a> 
</li> 
<li class="localnav-menu-item"> 
<a href="/augmented-reality/realitykit/" class="localnav-menu- 
link current" aria-disabled="true">RealityKit</a> 
</li> 
<li class="localnav-menu-item"> 


<a href="/augmented-reality/roomplan/" class="localnav- 
menu-link">RoomPlan</a> 
</li> 
<li class="localnav-menu-item"> 
<a href="/augmented-reality/tools/" class="localnav-menu- 
link">AR Creation Tools</a> 
</li> 
<li class="localnav-menu-item"> 
<a href="/augmented-reality/quick-look/" class="localnav- 
menu-link">AR Quick Look</a> 
</li> 
<li class="localnav-menu-item"> 
<a href="/augmented-reality/resources/" class="localnav- 
menu-link">Resources</a> 
</li> 
</ul> 
</div> 
<div class="localnav-actions localnav-actions"> 
<div class="localnav-action localnav-action-menucta" aria- 
hidden="true"> 
<label for="localnav-menustate" class="localnav-menucta"> 
<span class="localnav-menucta-chevron"></span> 
</label> 
</div> 
</div> 
</div> 
</div> 
</div> 
</nav> 
<label id="localnav-curtain" for="localnav-menustate"></label> 
<script src="/assets/scripts/ac-localnav.built.js"></script><div id="localnav- 
viewport-emitter" data-viewport-emitter-dispatch="" data-viewport-emitter- 
state="{ &quot;viewport&quot;:&quot;small&quot;, &quot;orientation&quot;:&quo 
t;portrait&quot;, &quot;retina&quot;:true}"></div> 
<script type="text/javascript" src="/assets/scripts/localnav.js"></script> 


<main id="main" class="main" role="main"> 


<section class="section section-hero"> 
<div class="section-content"> 
<div class="row"> 
<div class="large-centered large-9 small-12 

text-center"> 

<figure class="icon-realitykit center" 
data-hires-status="pending"></figure> 

<h1 class="typography- 
headline">RealityKit</h1> 

<p class="typography-intro">The 
RealityKit framework was built from the ground up specifically for augmented 
reality with photo-realistic rendering, camera effects, animations, physics, and 
more. With native Swift APIs, ARKit integration, incredibly realistic physics-based 
rendering, transform and skeletal animations, spatial audio, and rigid body 


physics, RealityKit makes AR development faster and easier than 
ever&nbsp;before.</p> 
</div> 
</div> 
</div> 
<div class="device-hero device-ipad-pro-12-9-space-gray- 
container center"> 
<figure class="device-screen screen-hero" data-hires- 
status="pending"></figure> 
<figure class="device-hardware" data-hires- 
status="pending" style="background-image: 
url(Gquot;https://developer.apple.com/assets/elements/hardware/ipad pro 12 9. 
space_gray/small_2x.png?156454&quot;);"></figure> 
</div> 
</section> 


<section class="section section-realitykit bg-yellow" data-hires- 
status="pending"> 
<div class="section-content"> 
<div class="row headline-row"> 
<div class="column large-centered large-12"> 


</div> 
</div> 
<div class="row"> 
<div class="column large-4 small-12"> 
<div class="device-wrap device-iphone- 
12-pro-silver-container device-medium-for-small"> 
<figure class="device-screen 
screen-object-capture" data-hires-status="pending"></figure> 
<figure class="device-hardware" 
data-hires-status="pending" style="background-image: 
url(&quot;https://developer.apple.com/assets/elements/hardware/iphone_12_pro_ 
silver/medium_2x.png?156454&quot;);"></figure> 
</div> 
</div> 
<div class="column large-7 medium-8 small- 
12"> 
<h3>Object Capture</h3> 
<p>Turn photos from your iPhone or iPad 
into photo-realistic 3D models that are optimized for AR in minutes* using the 
new Object Capture API on macOS. Object Capture uses photogrammetry to turn 
a series of pictures taken on your iPhone or iPad into 3D models that can be 
viewed instantly in AR Quick Look, or integrated into your Xcode 
project.</p><br> 
<a href="/augmented-reality/object- 
capture/" class="more">Learn more</a> 


</div> 
</div> 
</div> 
</section> 


<section class="section section-more"> 


<div class="section-content"> 
<div class="row"> 
<div class="column large-5 small-12"> 

<h3>Custom shaders</h3> 

<p>RealityKit seamlessly blends virtual 
content with the real world using realistic, physically based materials, 
environment reflections, grounding shadows, camera noise, motion blur, and 
more to make virtual content nearly indistinguishable from reality. <span 
class="nowrap">RealityKit</span> gives you more control over the rendering 
pipeline with custom render targets and materials, so you can fine-tune the look 
and feel of your AR objects and scene.</p> 


<h3>Custom systems</h3> 

<p>Build your own Entity Component 
System so you can organize the assets in your AR scene and build more complex 
functionality into the system layer.</p> 


<h3>Object occlusion</h3> 

<p>By combining information from the 
LIDAR Scanner and edge detection in RealityKit, virtual objects are able to 
interact with your physical surroundings just as you’d expect. Virtual objects can 
be placed under tables, behind walls, or around corners and you'll see only the 
parts of the virtual object you’d expect to, with crisp definition of where the 
physical object hides part of the virtual one.</p> 


<h3>Video texture</h3> 

<p>You can now add video textures to 
any part of your scene in RealityKit. This brings objects, surfaces, and even 
characters to life by adding rich video to animate virtual TV screens to play a 
movie, or make a virtual character smile.</p> 


<h3>Swift API</h3> 
<p>Easy to use yet incredibly powerful, 
RealityKit uses the rich language features of Swift to automatically provide the 
full feature set, so you can build AR experiences even more quickly, without the 
need for boilerplate code.</p> 
</div> 
<div class="column large-offset-2 large-5 small- 
offset-0 small-12"> 
<h3>Dynamic assets</h3> 
<p>Enable customizable loading for 
assets to give you more flexibility to tailor your RealityKit-based experiences — 
for example, programmatically changing an image or mesh with every 
frame.</p> 


<h3>Character Controller</h3> 

<p>Easily create player-controlled 
characters using this powerful Swift&nbsp;API, so your users can jump, scale, 
and explore the AR worlds and RealityKit-based games you create.</p> 


<h3>Scalable performance</h3> 

<p>Utilizing the latest Metal features to 
get the most out of the GPU, RealityKit takes full advantage of CPU caches and 
multiple cores to deliver incredibly fluid visuals and physics simulations. And 


because it automatically scales the performance of an AR experience to each 
iPhone or iPad, you only need to build a single AR experience.</p> 


<h3>Shared AR experiences</h3> 

<p>RealityKit simplifies building shared 
AR experiences by taking on the hard work of networking, such as maintaining a 
consistent state, optimizing network traffic, handling packet loss, or performing 
ownership transfers.</p> 

</div> 
</div> 
</div> 
</section> 
</main> 


<link rel="stylesheet" property="stylesheet" href="/assets/styles/router- 
strip.css" type="text/css"> 
<aside class="section developer-router-links"> 
<div class="section-content"> 
<div class="row"> 
<div class="column large-centered large-10 small-12 text- 
center"> 
<h2 class="typography-subsection- 
headline">Resources and documentation</h2> 
<p>View the latest documentation, sample code, 
videos, and forums.</p> 
</div> 
</div> 
<div class="row"> 
<div class="column large-3 medium-6 small-12"> 
<a href="/download/" class="block text-center"> 
<figure class="router-icon router-icon- 
download" data-hires-status="pending"></figure> 
<p><strong>SDKs and betas</strong></p> 
<p class="typography-subbody">Download 
SDKs and beta operating systems for all Apple platforms.</p> 
<p class="typography-subbody"><span 
class="block-link more">View Downloads</span></p> 
</a> 
</div> 
<div class="column large-3 medium-6 small-12"> 
<a href="/documentation/realitykit/" class="block 
text-center"> 
<figure class="router-icon router-icon- 
document" data-hires-status="pending"></figure> 
<p><strong>Documentation</strong></p> 
<p class="typography-subbody">Browse the 
latest documentation including API reference, articles, and 
sample&nbsp;code.</p> 
<p class="typography-subbody"><span 
class="block-link more">Read documentation</span></p> 
</a> 
</div> 
<div class="column large-3 medium-6 small-12"> 


<a href="/videos/graphics-games/" class="block text- 
center"> 
<figure class="router-icon router-icon-videos" 
data-hires-status="pending"></figure> 
<p><strong>Videos</strong></p> 
<p class="typography-subbody">Learn about 
the latest in Apple technologies presented at WWDC and other events.</p> 
<p class="typography-subbody"><span 
class="block-link more">Watch videos</span></p> 
</a> 
</div> 
<div class="column large-3 medium-6 small-12"> 
<a href="/forums/tags/realitykit/" class="block text- 
center"> 
<figure class="router-icon router-icon-forums" 
data-hires-status="pending"></figure> 
<p><strong>Forums</strong></p> 
<p class="typography-subbody">Ask questions 
and discuss development topics with Apple engineers and 
fellow&nbsp;developers.</p> 
<p class="typography-subbody"><span 
class="block-link more">View forums</span></p> 
</a> 
</div> 
</div> 
</div> 
</aside> 


<link rel="stylesheet" href="/assets/styles/footer.dist.css? 
41172203193"> 
<footer id="footer" class="footer" role="contentinfo" aria-labelledby="footer- 
label"> 
<div class="footer-content"> 
<h2 class="footer-label" id="footer-label">Developer Footer</h2> 
<section class="footer-sosumi"> 
<ul> 
<li>* Processing time will vary based on object complexity 
and other factors.</li> 
</ul> 
</section> 
<developer-breadcrumbs style="display: block;"> 


<nav class="footer-breadcrumbs" aria-label="Breadcrumbs"><a 
href="https://www.apple.com/" class="home footer-breadcrumbs-home"><span 
class="footer-breadcrumbs-home-icon" aria-hidden="true" data-hires- 
status="pending">[]</span><span class="footer-breadcrumbs-home- 
label">Apple</span></a><div class="footer-breadcrumbs-path"><ol 
class="footer-breadcrumbs-list"><li class="footer-breadcrumbs-item"><a 
href="/">Developer</a></li><li class="footer-breadcrumbs-item"><a 
href="/augmented-reality/">Augmented Reality</a></li><li class="footer- 
breadcrumbs-item">RealityKit Overview</li></ol></div></nav></developer- 
breadcrumbs> 


<nav class="footer-directory" aria-label="Apple Developer 
Directory" role="navigation"> 
<!--googleoff: all--> 
<div class="footer-directory-column"> 
<input class="footer-directory-column-section-state" 
type="checkbox" id="footer-directory-column-section-state-platform"> 
<div class="footer-directory-column-section"> 
<label class="footer-directory-column-section-label" 
for="footer-directory-column-section-state-platform"> 
<h3 class="footer-directory-column-section- 
title">Platforms</h3> 
</label> 
<a href="#footer-directory-column-section-state-platform" 
class="footer-directory-column-section-anchor footer-directory-column-section- 
anchor-open"> <span class="footer-directory-column-section-anchor- 
label">Open Menu</span> </a> 
<a href="#" class="footer-directory-column-section-anchor 
footer-directory-column-section-anchor-close"> <span class="footer-directory- 
column-section-anchor-label">Close Menu</span> </a> 
<ul class="footer-directory-column-section-list"> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/ios/">iOS</a> </li> 
<li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/ipados/">iPadOS</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/macos/">macOS</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/tvos/">tvOS</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="/watchos/">watchOS</a></li> 
</ul> 
</div> 


<input class="footer-directory-column-section-state" 
type="checkbox" id="footer-directory-column-section-state-tools"> 
<div class="footer-directory-column-section"> 
<label class="footer-directory-column-section-label" 
for="footer-directory-column-section-state-tools"> 
<h3 class="footer-directory-column-section- 
title">Tools</h3> 
</label> 
<a href="#footer-directory-column-section-state-tools" 
class="footer-directory-column-section-anchor footer-directory-column-section- 
anchor-open"> <span class="footer-directory-column-section-anchor- 
label">Open Menu</span> </a> 
<a href="#" class="footer-directory-column-section-anchor 
footer-directory-column-section-anchor-close"> <span class="footer-directory- 
column-section-anchor-label">Close Menu</span> </a> 
<ul class="footer-directory-column-section-list"> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/swift/">Swift</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/swiftui/">SwiftUl</a></li> 


«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/swift-playgrounds/">Swift 
Playgrounds</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="/testflight/">TestFlight</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/xcode/">Xcode</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/xcode-cloud/">Xcode 
Cloud</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/sf-symbols/">SF 
Symbols</a></li> 
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class="footer-directory-column-section-anchor footer-directory-column-section- 
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<a href="#" class="footer-directory-column-section-anchor 
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«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="/accessories/">Accessories</a></li> 
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class="footer-directory-column-section-link" href="/app-extensions/">App 
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«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/fonts/">Fonts</a></li> 
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Purchase</a></li> 

«li class="footer-directory-column-section-item"><a 
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href="/localization/">Localization</a></li> 
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class="footer-directory-column-section-link" href="/maps/">Maps &amp; 
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Learning</a></li> 
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href="/security/">Security</a></li> 
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class="footer-directory-column-section-link" href="/safari/">Safari &amp; 
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value="https://developer.apple.com/augmented-reality/realitykit/">English</ 
option><option 
value="https://developer.apple.com/cn/augmented-reality/realitykit/"» Q000</ 
option><option 
value="https://developer.apple.com/jp/augmented-reality/realitykit/"» JOO«/ 
option» «option 
value="https://developer.apple.com/kr/augmented-reality/realitykit/">[00</ 
option></select> 
<span class="dropdown-icon icon icon-chevrondown" aria- 
hidden="true"></span> 
</div> 
<script async="" src="/assets/scripts/lib/jquery/jquery.language- 
dropdown.js?41172203193"></script> 
<div class="footer-mini-legal"> 
<div class="footer-mini-legal-copyright">Copyright © 2022 <a 
href="https://www.apple.com">Apple Inc.</a> All rights reserved.</div> 
<div class="footer-mini-legal-links"> 
<a class="footer-mini-legal-link" 
href="https://www.apple.com/legal/internet-services/terms/site.html">Terms of 
Use</a> 
<a class="footer-mini-legal-link" 
href="https://www.apple.com/legal/privacy/en-ww/">Privacy Policy</a> 
<a class="footer-mini-legal-link" 
href="/support/terms/">Agreements and Guidelines</a> 
</div> 
</div> 
</section> 
</div> 
</footer> 


</body></html><html xmins="https://www.w3.org/1999/xhtml" xml:lang="en" 
lang="en"><head> 

<link rel="stylesheet" href="https://www.apple.com/wss/fonts? 
family=SF+Pro&amp;v=2" type="text/css"> 
<link rel="stylesheet" href="https://www.apple.com/wss/fonts? 
family=SF+Pro+lcons&amp;v=1" type="text/css"> 
<link rel="stylesheet" href="https://www.apple.com/wss/fonts? 
family=SF+Mono&amp;v=2" type="text/css"> 
<link rel="stylesheet" href="https://www.apple.com/wss/fonts? 
family=Apple+lcons&amp;v=1" type="text/css"> 


<meta charset="utf-8"> 
<meta name="Author" content="Apple Inc."> 
<meta name="viewport" content="width=device-width, initial-scale=1, 
viewport-fit=cover"> 
<link rel="shortcut icon" href="/favicon.ico"> 


<link rel="icon" href="/favicon.ico"> 
<link rel="mask-icon" href="/apple-logo.svg" color="#333333"> 


<link rel="stylesheet" href="/assets/styles/global.dist.css?41172203193" 
type="text/css"> 


<link rel="stylesheet" href="/assets/styles/localization.css?41172203193" 
type="text/css"> 


<script src="/assets/scripts/lib/jquery/jquery-3.6.0.min.js?41172203193"></ 
script> 

<script src="/assets/scripts/settings.js?41172203193"></script> 

<script src="/assets/scripts/language-locales.js?41172203193"></script> 
<script src="/assets/scripts/DeveloperBreadcrumbs.js?41172203193"></script> 


<script async="" src="/assets/scripts/lib/jquery/jquery.retinate.js? 
41172203193"></script> 

<script async="" src="/assets/scripts/global.js?41172203193"></script> 
<script async="" src="/assets/scripts/global-logout.js?41172203193"></script> 


<title>RoomPlan Overview - Augmented Reality - Apple 
Developer</title> 

<meta name="omni_page" content="RoomPlan - Augmented 
Reality - (English)"> 

<meta name="Description" content="RoomPlan is a new Swift API 
that utilizes the camera and LIDAR Scanner on iPhone and iPad to create a 3D 
floor plan of a room with characteristics like dimensions and type of furniture 
included."> 


<meta property="og:locale" content="en_US"> 

<meta property="og:site name" content="Apple Developer"> 

<meta property="og:type" content="website"> 

<meta property="og:image" 
content="https://developer.apple.com/news/images/og/roomplan-og.jpg"> 

<meta property="og:title" content="RoomPlan - Augmented Reality 
- Apple Developer"> 

<meta property="og:description" content="RoomPlan is a new 
Swift API that utilizes the camera and LIDAR Scanner on iPhone and iPad to 
create a 3D floor plan of a room with characteristics like dimensions and type of 
furniture included."> 

<meta property="og:url" 
content="https://developer.apple.com/augmented-reality/roomplan/"> 


<meta name="twitter:card" content="summary_large_image"> 

<meta name="twitter:image" 
content="https://developer.apple.com/news/images/og/roomplan-og- 
twitter.jpg"> 

<meta name="twitter:description" content="RoomPlan is a new 
Swift API that utilizes the camera and LiDAR Scanner on iPhone and iPad to 
create a 3D floor plan of a room with characteristics like dimensions and type of 
furniture included."> 

<meta name="twitter:title" content="RoomPlan - Augmented 
Reality - Apple Developer"> 


<meta name="twitter:url" 
content="https://developer.apple.com/augmented-reality/roomplan/"> 


<link rel="alternate" 
href="https://developer.apple.com/kr/augmented-reality/roomplan/" 
hreflang="ko-KR"> 

<link rel="alternate" 
href="https://developer.apple.com/jp/augmented-reality/roomplan/" 
hreflang="ja-JP"> 

<link rel="alternate" 
href="https://developer.apple.com/cn/augmented-reality/roomplan/" 
hreflang="zh-CN"> 

<link rel="alternate" 
href="https://developer.apple.com/augmented-reality/roomplan/" 
hreflang="en"> 

<link rel="canonical" 
href="https://developer.apple.com/augmented-reality/roomplan/"> 


<link rel="stylesheet" href="/augmented-reality/styles/augmented- 
reality-alt.css" type="text/css"> 
<link rel="stylesheet" 
href="/augmented-reality/styles/roomplan.css" type="text/css"> 
</head> 


<body id="roomplan" class="dmf" data-color-scheme="light"> 
<link rel="stylesheet" href="/assets/styles/globalnav.css? 
41172203193" type="text/css"> 


<link rel="stylesheet" href="/assets/styles/suggest-lang.css?41172203193" 
type="text/css"> 
<div id="suggest-lang" class="ribbon hide"> 
<div class="ribbon-content-wrapper"> 
<div class="ribbon-content row"> 
<div class="column large-12 large-centered"> 

<a id="suggest-closer" class="icon icon-after icon- 
reset"></a> 

<p><a href="#" id="suggest-link" class="ribbon-link 
more">View in English</a></p> 

</div> 
</div> 
</div> 

</div> 
<script src="/assets/scripts/suggest-lang.js?41172203193"></script> 
<aside id="ac-gn-segmentbar" class="ac-gn-segmentbar" lang="en-US" 
dir="ltr"> 
</aside> 
<input type="checkbox" id="ac-gn-menustate" class="ac-gn-menustate"> 
<nav id="ac-globalnav" class="js touch no-windows" role="navigation" aria- 
label="Global" data-hires="false" data-analytics-region="global nav" lang="en- 
US" dir="Itr" data-www-domain="www.apple.com" data-store-locale="us" data- 
store-root-path="/us" data-store-api="/[storefront]/shop/bag/status" data- 
search-locale="en_US" 
data-search-suggestions-api="/search-services/suggestions/" data-search- 


defaultlinks-api="/search-services/suggestions/defaultlinks/" data-search- 
suggestions-enabled="false"> 
<div class="ac-gn-content"> 
<ul class="ac-gn-header"> 
<li class="ac-gn-item ac-gn-menuicon"> 
<label class="ac-gn-menuicon-label" for="ac-gn- 
menustate" aria-hidden="true"> 
<span class="ac-gn-menuicon-bread ac-gn- 
menuicon-bread-top"> 
<span class="ac-gn-menuicon-bread- 
crust ac-gn-menuicon-bread-crust-top"></span> 
</span> 
<span class="ac-gn-menuicon-bread ac-gn- 
menuicon-bread-bottom"> 
<span class="ac-gn-menuicon-bread- 
crust ac-gn-menuicon-bread-crust-bottom"></span> 
</span> 
</label> 
<a href="#ac-gn-menustate" role="button" class="ac- 
gn-menuanchor ac-gn-menuanchor-open" id="ac-gn-menuanchor-open"> 
<span class="ac-gn-menuanchor-label">Global 
Nav Open Menu</span> 
</a> 
<a href="#" role="button" class="ac-gn-menuanchor 
ac-gn-menuanchor-close" id="ac-gn-menuanchor-close"> 
<span class="ac-gn-menuanchor-label">Global 
Nav Close Menu</span> 
</a> 
</li> 
<li class="ac-gn-item ac-gn-apple"> 
<a class="ac-gn-link ac-gn-link-apple-developer" 
href="/" data-analytics-title="appledeveloper home" id="ac-gn-firstfocus- 
small"> 
<span class="ac-gn-link-text">Apple 
Developer</span> 
</a> 
</li> 
</ul> 
<div class="ac-gn-search-placeholder-container" role="search"> 
<div class="ac-gn-search ac-gn-search-small"> 
<a id="ac-gn-link-search-small" class="ac-gn-link" 
href="/search/" data-analytics-title="search" data-analytics-click="search" data- 
analytics-intrapage-link="" aria-label="Search" role="button" aria- 
haspopup="true"> 
<div class="ac-gn-search-placeholder-bar"> 
<div class="ac-gn-search-placeholder- 
input" > 
<div class="ac-gn-search- 
placeholder-input-text" aria-hidden="true"> 
<div class="ac-gn-link- 
search ac-gn-search-placeholder-input-icon"></div> 
<span class="ac-gn-search- 
placeholder">Search</span> 
</div> 


</div> 
<div class="ac-gn-searchview-close ac- 
gn-searchview-close-small ac-gn-search-placeholder-searchview-close"> 
<span class="ac-gn-searchview- 
close-cancel" aria-hidden="true">Cancel</span> 
</div> 
</div> 
</a> 
</div> 
</div> 
<ul class="ac-gn-list"> 
<li class="ac-gn-item ac-gn-apple"> 
<a class="ac-gn-link ac-gn-link-apple-developer" 
href="/" data-analytics-title="appledeveloper home" id="ac-gn-firstfocus"> 
<span class="ac-gn-link-text">Apple 
Developer</span> 
</a> 
</li> 
<li class="ac-gn-item ac-gn-item-menu ac-gn-news"> 
<a class="ac-gn-link ac-gn-link-news" href="/news/" 
data-analytics-title="news"> 
<span class="ac-gn-link-text">News</span> 
</a> 
</li> 
<li class="ac-gn-item ac-gn-item-menu ac-gn-discover"> 
<a class="ac-gn-link ac-gn-link-discover" 
href="/discover/" data-analytics-title="discover"> 
<span 
class="ac-gn-link-text">Discover</span> 
</a> 
</li> 
<li class="ac-gn-item ac-gn-item-menu ac-gn-design"> 
<a class="ac-gn-link ac-gn-link-design" href="/design/" 
data-analytics-title="design"> 
<span class="ac-gn-link-text">Design</span> 
</a> 
</li> 
<li class="ac-gn-item ac-gn-item-menu ac-gn-develop"> 
<a class="ac-gn-link ac-gn-link-develop" 
href="/develop/" data-analytics-title="develop"> 
<span class="ac-gn-link-text">Develop</span> 
</a> 
</li> 
<li class="ac-gn-item ac-gn-item-menu ac-gn-distribute"> 
<a class="ac-gn-link ac-gn-link-distribute" 
href="/distribute/" data-analytics-title="distribute"> 
<span 
class="ac-gn-link-text">Distribute</span> 
</a> 
</li> 
<li class="ac-gn-item ac-gn-item-menu ac-gn-dsupport"> 
<a class="ac-gn-link ac-gn-link-dsupport" 
href="/support/" data-analytics-title="dsupport"> 
<span class="ac-gn-link-text">Support</span> 


</a> 
</li> 
<li class="ac-gn-item ac-gn-item-menu ac-gn-account"> 
<a class="ac-gn-link ac-gn-link-account" 
href="/account/" data-analytics-title="account"> 
<span class="ac-gn-link-text">Account</span> 
</a> 
</li> 
<li class="ac-gn-item ac-gn-item-menu ac-gn-search" 
role="search"> 
<a id="ac-gn-link-search" class="ac-gn-link ac-gn-link- 
search" href="/search/" data-analytics-title="search" data-analytics- 
click="search" data-analytics-intrapage-link="" aria-label="Search" 
role="button" aria-haspopup="true"></a> 
</li> 
</ul> 
<aside id="ac-gn-searchview" class="ac-gn-searchview" 
role="search" data-analytics-region="search"> 
<div class="ac-gn-searchview-content"> 
<div class="ac-gn-searchview-bar"> 
<div class="ac-gn-searchview-bar-wrapper"> 
<form id="ac-gn-searchform" class="ac- 
gn-searchform" action="/search/" method="get"> 
<div class="ac-gn-searchform- 
wrapper"> 
<input id="ac-gn- 
searchform-input" class="ac-gn-searchform-input" type="text" name="q" aria- 
label="Search" placeholder="Search" autocorrect="off" autocapitalize="off" 
autocomplete="off" spellcheck="false" role="combobox" aria- 
autocomplete="list" aria-expanded="true" aria-owns="quicklinks suggestions"> 
<button id="ac-gn- 
searchform-submit" class="ac-gn-searchform-submit" type="submit" 
disabled="" aria-label="Submit Search"></button> 
<button id="ac-gn- 
searchform-reset" class="ac-gn-searchform-reset" type="reset" disabled="" 
aria-label="Clear Search"> 


<span 
class="ac-gn-searchform-reset-background"></span> 
</button> 
</div> 
</form> 


<button id="ac-gn-searchview-close- 
small" class="ac-gn-searchview-close ac-gn-searchview-close-small" aria- 
label="Cancel Search"> 
<span class="ac-gn- 
searchview-close-cancel" aria-hidden="true"> 
Cancel 
</span> 
</button> 
</div> 
</div> 
<aside id="ac-gn-searchresults" class="ac-gn- 
searchresults" data-string-quicklinks="Quick Links" data-string- 
suggestions="Suggested Searches" data-string-noresults=""> 


<section class="ac-gn-searchresults-section ac-gn-searchresults- 
section-defaultlinks"> 
<div class="ac-gn-searchresults-section-wrapper"> 
<div class="search-group- 
checkbox hidden"><input id="group-input" type="checkbox" name="group- 
filter" checked="">Only search within “<span 
id="group-search-label"></span>" </div> 
<h3 class="ac-gn-searchresults-header ac-gn-searchresults- 
animated">Quick Links</h3> 
<ul class="ac-gn-searchresults-list" id="defaultlinks" 
role="listbox"> 
<li class="ac-gn-searchresults-item ac-gn-searchresults- 
animated"><a href="https://developer.apple.com/ios/" id="search-group-link-0" 
class="ac-gn-searchresults-link ac-gn-searchresults-link-defaultlinks">iOS 
16</a></li><li class="ac-gn-searchresults-item ac-gn-searchresults- 
animated"><a href="https://developer.apple.com/news/" id="search-group-link- 
1" class="ac-gn-searchresults-link ac-gn-searchresults-link-defaultlinks">Latest 
News</a></li><li class="ac-gn-searchresults-item ac-gn-searchresults- 
animated"><a 
href="https://developer.apple.com/documentation/storekit/appstore/ 
environment/3963900-xcode/" id="search-group-link-2" class="ac-gn- 
searchresults-link ac-gn-searchresults-link-defaultlinks">xcode</a></li><li 
class="ac-gn-searchresults-item ac-gn-searchresults-animated"><a 
href="https://developer.apple.com/xcode/whats-new/" id="search-group-link-3" 
class="ac-gn-searchresults-link ac-gn-searchresults-link-defaultlinks">What's 
included in Xcode</a></li><li class="ac-gn-searchresults-item ac-gn- 
searchresults-animated"><a 
href="https://developer.apple.com/videos/play/wwdc2022/110345/" id="search- 
group-link-4" class="ac-gn-searchresults-link ac-gn-searchresults-link- 
defaultlinks">What’s new in Endpoint Security</a></li></ul> 
<span role="status" class="ac-gn-searchresults-count" aria- 
live="polite">5 Quick Links</span> 
</div> 
</section> 
</aside> 
</div> 
<button id="ac-gn-searchview-close" class="ac-gn- 
searchview-close" aria-label="Cancel Search"> 
<span class="ac-gn-searchview-close- 
wrapper"> 
<span class="ac-gn-searchview-close- 
left"></span> 
<span class="ac-gn-searchview-close- 
right"></span> 
</span> 
</button> 
</aside> 
</div> 
</nav> 
<div class="ac-gn-blur"></div> 
<div id="ac-gn-curtain" class="ac-gn-curtain"></div> 
<div id="ac-gn-placeholder" class="ac-nav-placeholder"></div> 
<script src="/assets/scripts/ac-globalnav.built.js?41172203193"></script><div 
id="ac-gn-viewport-emitter"> </div> 


<link rel="stylesheet" href="/assets/styles/search.css?41172203193"> 
<script src="/assets/scripts/search.js?41172203193"></script> 


<!-- metrics --> 
<script> 
/* RSID: */ 
var s account="awdappledeveloper" 
</script> 
<script src="/assets/metrics/scripts/analytics.js?10202020"></script> 
<script> 
s.pageName= AC && AC.Tracking && AC.Tracking.pageName(); 
s.channel="www.en.developer" 
s.channel="www.en.developer"; 


peopepopocoraxx DO NOT ALTER ANYTHING BELOW THIS LINE ! Ferrer / 
var s code=s.t();if(s code)document.write(s code) 

</script> 

<!-- /metrics --> 


<link rel="stylesheet" property="stylesheet" 
href="/assets/styles/localnav.css" type="text/css"> 
<input type="checkbox" id="localnav-menustate" class="localnav-menustate"> 
<div id="localnav-sticky-placeholder" class="css-sticky"></div><nav 
id="localnav" class="localnav localnav-scrim css-sticky" data-sticky="" 
role="navigation"> 
<div class="localnav-wrapper"> 
<div class="localnav-background"></div> 
<div class="localnav-content"> 
<h2 class="localnav-title"> 
<a href="/augmented-reality/">Augmented Reality</a> 
</h2> 


<div class="localnav-menu"> 
<a href="#localnav-menustate" class="localnav-menucta-anchor 
localnav-menucta-anchor-open" id="localnav-menustate-open"> 
<span class="localnav-menucta-anchor-label">Open Menu</span> 
</a> 
<a href="#" class="localnav-menucta-anchor localnav-menucta- 
anchor-close" id="localnav-menustate-close"> 
<span class="localnav-menucta-anchor-label">Close Menu</span> 
</a> 
<div class="localnav-menu-tray"> 
<ul class="localnav-menu-items"> 
<li class="localnav-menu-item"> 
<a href="/augmented-reality/" class="localnav-menu- 
link">Overview</a> 
</li> 
<li class="localnav-menu-item"> 
<a href="/augmented-reality/arkit/" class="localnav-menu- 
link">ARKit</a> 
</li> 
<li class="localnav-menu-item"> 


<a href="/augmented-reality/realitykit/" class="localnav-menu- 
link">RealityKit</a> 
</li> 
<li class="localnav-menu-item"> 
<a href="/augmented-reality/roomplan/" class="localnav- 
menu-link current" aria-disabled="true">RoomPlan</a> 
</li> 
<li class="localnav-menu-item"> 
<a href="/augmented-reality/tools/" class="localnav-menu- 
link">AR Creation Tools</a> 
</li> 
<li class="localnav-menu-item"> 
<a href="/augmented-reality/quick-look/" class="localnav- 
menu-link">AR Quick Look</a> 
</li> 
<li class="localnav-menu-item"> 
<a href="/augmented-reality/resources/" class="localnav- 
menu-link">Resources</a> 
</li> 
</ul> 
</div> 
<div class="localnav-actions localnav-actions"> 
<div class="localnav-action localnav-action-menucta" aria- 
hidden="true"> 
<label for="localnav-menustate" class="localnav-menucta"> 
<span class="localnav-menucta-chevron"></span> 
</label> 
</div> 
</div> 
</div> 
</div> 
</div> 
</nav> 
<label id="localnav-curtain" for="localnav-menustate"></label> 
<script src="/assets/scripts/ac-localnav.built.js"></script><div id="localnav- 
viewport-emitter" data-viewport-emitter-dispatch="" data-viewport-emitter- 
state="{ &quot;viewport&quot;:&quot;small&quot;, &quot;orientation&quot;:&quo 
t;portrait&quot;,&quot;retina&quot;:true}"></div> 
<script type="text/javascript" src="/assets/scripts/localnav.js"></script> 


<main id="main" class="main" role="main"> 
<div class="ribbon ribbon-blue"> 
<div class="ribbon-drop-wrapper"> 
<div class="ribbon-content-wrapper"> 
<div class="ribbon-content row"> 
<div class="column large-centered 
large-12"> 
<p> 
<a 

href="/videos/play/wwdc2022/10127/" class="ribbon-link">Watch “Create 
parametric 3D room scans with RoomPlan” <span class="icon icon-after icon- 
playcircle nowrap">from WWDC22<span 
class="loc-wip-sub"></span></span></a> 


</p> 
</div> 
</div> 
</div> 
</div> 
</div> 


<section class="section section-hero"> 
<div class="section-content"> 
<div class="row"> 
<div class="column large-centered large- 
9 small-12 text-center"> 
<figure class="icon-roomplan 
center" data-hires-status="pending"></figure> 
<hl><span 
class="nowrap">Introducing RoomPlan</span></h1> 
<p class="typography- 
intro">Powered by ARKit, RoomPlan is a new Swift API that utilizes the camera 
and LIDAR Scanner on iPhone and iPad to create a 3D floor plan of a room, 
including key characteristics such as dimensions and types 
of&nbsp;furniture.</p> 
</div> 
</div> 
</div> 
<div class="section section-video"> 
<div class="row"> 
<div class="column large-centered large- 
12 medium-12 small-12 text-center video-max-width"> 
<video id="video" class="video 
large-centered" autoplay="" muted="" playsinline="" data-source-fallback- 
landscape="/augmented-reality/roomplan/videos/roomplan-large.mp4" 
src="/augmented-reality/roomplan/videos/roomplan-large.mp4"></video> 
</div> 
</div> 
</div> 
</section> 


<section class="section section-discover"> 
<div class="section-content"> 
<div class="row"> 
<div class="row headline-row"> 
<div class="column large-8 small- 
12 large-centered small-uncentered"> 
<h2>Bring surroundings into 
your app with&nbsp;RoomPlan</h2> 
</div> 
</div> 
<div class="row"> 
<div class="column large-6 small- 
12"> 
<h4>Engage customers, 
streamline workflows</h4> 
<p>Help customers make 
more informed decisions by using RoomPlan to create a floor plan of a room 


directly in your apps, such as real estate, e-commerce, or hospitality apps. These 
scans can also be the first step in architecture and interior design workflows to 
help streamline conceptual exploration and planning.</p> 


<h4>Real-time scanning 
with LIDAR</h4> 

<p>Completely customize 
your app's user experience and scan guidance, or utilize the built-in coaching UI 
for optimal scans, visual feedback illustrating real-time scanning progress, and a 
dollhouse visualization that shows everything in the room that has been 
recognized.</p> 


<h4>Parametric 
representation</h4> 
<p>RoomPlan outputs in 
USD or USDZ file formats that include dimensions of each component recognized 
in the room, such as walls or cabinets, as well as the type of furniture detected. 
The dimensions and placement of each individual component can be further 
adjusted when exported into various USDZ-compatible tools, such as <span 
class="nowrap">Cinema 4D,</span> Shapr3D, or&nbsp;AutoCAD. </p> 
</div> 
<div class="column large-6 small- 
12"> 
<div class="device-hero 
device-ipad-pro-11-space-gray-vert-container device-medium-for-large device- 
small-for-small"> 
<picture 
class="device-screen"> 
<source 
media="(max-width: 735px)" 
srcset="/augmented-reality/roomplan/images/screen-hero-small_2x.jpg"> 
<source 
media="(max-width: 1068px)" 
srcset="/augmented-reality/roomplan/images/screen-hero-medium_2x.jpg"> 
<img 
src="/augmented-reality/roomplan/images/screen-hero-large_2x.jpg" 
width="100%" alt="iPad Pro displaying RoomPlan" aria-label="iPad Pro 
displaying RoomPlan" data-hires-status="pending"> 
</picture> 
<figure class="device- 
hardware" data-hires-status="pending" style="background-image: 
url(Gquot;https://developer.apple.com/assets/elements/hardware/ipad pro 11 sp 
ace_gray_vert/small_2x.png?156454&quot;);"></figure> 
</div> 
</div> 
</div> 
</div> 
</div> 
</section> 
</main> 


<link rel="stylesheet" property="stylesheet" 
href="/assets/styles/router-strip.css" type="text/css"> 
<aside class="section developer-router-links"> 


<div class="section-content"> 
<div class="row"> 
<div class="column large-centered large-10 small-12 text- 
center"> 
<h2 class="typography-subsection- 
headline">Resources and documentation</h2> 
<p>Download the latest version of Xcode and use 
these resources to create AR experiences.</p> 
</div> 
</div> 
<div class="row"> 
<div class="column large-3 medium-6 small-12"> 
<a href="/download/" class="block text-center"> 
<figure class="router-icon router-icon- 
download" data-hires-status="pending"></figure> 
<p><strong>SDKs and betas</strong></p> 
<p class="typography-subbody">Download 
SDKs and beta operating systems for all Apple platforms.</p> 
<p class="typography-subbody"><span 
class="block-link more">View Downloads<span 
class="loc-en-only"></span></span></p> 
</a> 
</div> 
<div class="column large-3 medium-6 small-12"> 
<a href="/documentation/roomplan" class="block 
text-center"> 
<figure class="router-icon router-icon- 
document" data-hires-status="pending"></figure> 
<p><strong>Documentation</strong></p> 
<p class="typography-subbody">Browse the 
latest documentation including API reference, articles, and 
sample&nbsp;code.</p> 
<p class="typography-subbody"><span 
class="block-link more">Read documentation<span 
class="loc-en-only"></span></span></p> 
</a> 
</div> 
<div class="column large-3 medium-6 small-12"> 
<a href="/videos/graphics-games/" class="block text- 
center"> 
<figure class="router-icon router-icon-videos" 
data-hires-status="pending"></figure> 
<p><strong>Videos</strong></p> 
<p class="typography-subbody">Learn about 
the latest in Apple technologies presented at WWDC and other events.</p> 
<p class="typography-subbody"><span 
class="block-link more">Watch videos<span 
class="loc-partial-sub"></span></span></p> 
</a> 
</div> 
<div class="column large-3 medium-6 small-12"> 
<a href="/forums/tags/room-plan/" class="block text- 
center"> 


<figure class="router-icon router-icon-forums" 
data-hires-status="pending"></figure> 

<p><strong>Forums</strong></p> 

<p class="typography-subbody">Ask questions 
and discuss development topics with Apple engineers and 
other&nbsp;developers.</p> 

<p class="typography-subbody"><span 
class="block-link more">View forums<span 
class="loc-en-only"></span></span></p> 

</a> 
</div> 
</div> 
</div> 

</aside> 


<link rel="stylesheet" href="/assets/styles/footer.dist.css? 
41172203193"> 
<footer id="footer" class="footer" role="contentinfo" aria-labelledby="footer- 
label"> 
<div class="footer-content"> 
<h2 class="footer-label" id="footer-label">Developer Footer</h2> 
<developer-breadcrumbs style="display: block;"> 


<nav class="footer-breadcrumbs" aria-label="Breadcrumbs"><a 
href="https://www.apple.com/" class="home footer-breadcrumbs-home"><span 
class="footer-breadcrumbs-home-icon" aria-hidden="true" data-hires- 
status="pending">[]</span><span class="footer-breadcrumbs-home- 
label">Apple</span></a><div class="footer-breadcrumbs-path"><ol 
class="footer-breadcrumbs-list"><li class="footer-breadcrumbs-item"><a 
href="/">Developer</a></li><li class="footer-breadcrumbs-item"><a 
href="/augmented-reality/">Augmented Reality</a></li><li class="footer- 
breadcrumbs-item">RoomPlan</li></ol></div></nav></developer- 
breadcrumbs> 
<nav class="footer-directory" aria-label="Apple Developer 
Directory" role="navigation"> 
<!--googleoff: all--> 
<div class="footer-directory-column"> 
<input class="footer-directory-column-section-state" 
type="checkbox" id="footer-directory-column-section-state-platform"> 
<div class="footer-directory-column-section"> 
<label class="footer-directory-column-section-label" 
for="footer-directory-column-section-state-platform"> 
<h3 class="footer-directory-column-section- 
title">Platforms</h3> 
</label> 
<a href="#footer-directory-column-section-state-platform" 
class="footer-directory-column-section-anchor footer-directory-column-section- 
anchor-open"> <span class="footer-directory-column-section-anchor- 
label">Open Menu</span> </a> 
<a href="#" class="footer-directory-column-section-anchor 
footer-directory-column-section-anchor-close"> <span class="footer-directory- 
column-section-anchor-label">Close Menu</span> </a> 
<ul class="footer-directory-column-section-list"> 


«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/ios/">iOS</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/ipados/">iPadOS</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/macos/">macOS</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/tvos/">tvOS</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="/watchos/">watchOS</a></li> 

</ul> 
</div> 


<input class="footer-directory-column-section-state" 
type="checkbox" id="footer-directory-column-section-state-tools"> 
<div class="footer-directory-column-section"> 
<label class="footer-directory-column-section-label" 
for="footer-directory-column-section-state-tools"> 
<h3 class="footer-directory-column-section- 
title">Tools</h3> 
</label> 
<a href="#footer-directory-column-section-state-tools" 
class="footer-directory-column-section-anchor footer-directory-column-section- 
anchor-open"> <span class="footer-directory-column-section-anchor- 
label">Open Menu</span> </a> 
<a href="#" class="footer-directory-column-section-anchor 
footer-directory-column-section-anchor-close"> <span class="footer-directory- 
column-section-anchor-label">Close Menu</span> </a> 
<ul class="footer-directory-column-section-list"> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/swift/">Swift</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/swiftui/">SwiftUl</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/swift-playgrounds/">Swift 
Playgrounds</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="/testflight/">TestFlight</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/xcode/">Xcode</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/xcode-cloud/">Xcode 
Cloud</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/sf-symbols/">SF 
Symbols</a></li> 
</ul> 
</div> 
</div> 


<div class="footer-directory-column"> 


<input class="footer-directory-column-section-state" 
type="checkbox" id="footer-directory-column-section-state-topics"> 
<div class="footer-directory-column-section"> 
<label class="footer-directory-column-section-label" 
for="footer-directory-column-section-state-topics"> 
<h3 class="footer-directory-column-section- 
title">Topics &amp; Technologies</h3> 
</label> 
<a href="#footer-directory-column-section-state-topics" 
class="footer-directory-column-section-anchor footer-directory-column-section- 
anchor-open"> <span class="footer-directory-column-section-anchor- 
label">Open Menu</span> </a> 
<a href="#" class="footer-directory-column-section-anchor 
footer-directory-column-section-anchor-close"> <span class="footer-directory- 
column-section-anchor-label">Close Menu</span> </a> 
<ul class="footer-directory-column-section-list"> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="/accessibility/">Accessibility</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="/accessories/">Accessories</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/app-extensions/">App 
Extensions</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/app-store/">App 
Store</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/audio/">Audio &amp; 
Video</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/augmented- 
reality/">Augmented Reality</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="/business/">Business</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/design/">Design</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="/distribute/">Distribution</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="/education/">Education</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/fonts/">Fonts</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/games/">Games</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/health-fitness/">Health 
&amp; Fitness</a></li> 


«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/in-app-purchase/">In-App 
Purchase</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="/localization/">Localization</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/maps/">Maps &amp; 
Location</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/machine-learning/">Machine 
Learning</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="/security/">Security</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/safari/">Safari &amp; 
Web</a></li> 

</ul> 
</div> 
</div> 


<div class="footer-directory-column"> 
<input class="footer-directory-column-section-state" 
type="checkbox" id="footer-directory-column-section-state-resources"> 
<div class="footer-directory-column-section"> 
<label class="footer-directory-column-section-label" 
for="footer-directory-column-section-state-resources"> 
<h3 class="footer-directory-column-section- 
title">Resources</h3> 
</label> 
<a href="#footer-directory-column-section-state-resources" 
class="footer-directory-column-section-anchor footer-directory-column-section- 
anchor-open"> <span class="footer-directory-column-section-anchor- 
label">Open Menu</span> </a> 
<a href="#" class="footer-directory-column-section-anchor 
footer-directory-column-section-anchor-close"> <span class="footer-directory- 
column-section-anchor-label">Close Menu</span> </a> 
<ul class="footer-directory-column-section-list"> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="/documentation/">Documentation</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="/learn/curriculum/">Curriculum</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="/download/">Downloads</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="https://developer.apple.com/forums/">Forums</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/videos/">Videos</a></li> 
</ul> 


</div> 


<input class="footer-directory-column-section-state" 
type="checkbox" id="footer-directory-column-section-state-support"> 
<div class="footer-directory-column-section"> 
<label class="footer-directory-column-section-label" 
for="footer-directory-column-section-state-support"> 
<h3 class="footer-directory-column-section- 
title">Support</h3> 
</label> 
<a href="#footer-directory-column-section-state-support" 
class="footer-directory-column-section-anchor footer-directory-column-section- 
anchor-open"> <span class="footer-directory-column-section-anchor- 
label">Open Menu</span> </a> 
<a href="#" class="footer-directory-column-section-anchor 
footer-directory-column-section-anchor-close"> <span class="footer-directory- 
column-section-anchor-label">Close Menu</span> </a> 
<ul class="footer-directory-column-section-list"> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/support/articles/">Support 
Articles</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/contact/">Contact 
Us</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/bug-reporting/">Bug 
Reporting</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/system-status/">System 
Status</a></li> 
</ul> 
</div> 


<input class="footer-directory-column-section-state" 
type="checkbox" id="footer-directory-column-section-state-account"> 
<div class="footer-directory-column-section"> 
<label class="footer-directory-column-section-label" 
for="footer-directory-column-section-state-account"> 
<h3 class="footer-directory-column-section- 
title" >Account</h3> 
</label> 
<a href="#footer-directory-column-section-state-account" 
class="footer-directory-column-section-anchor footer-directory-column-section- 
anchor-open"> <span class="footer-directory-column-section-anchor- 
label">Open Menu</span> </a> 
<a href="#" class="footer-directory-column-section-anchor 
footer-directory-column-section-anchor-close"> <span class="footer-directory- 
column-section-anchor-label">Close Menu</span> </a> 
<ul class="footer-directory-column-section-list"> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/account/">Apple 
Developer</a></li> 


«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="https://appstoreconnect.apple.com/">App Store Connect</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="/account/ios/certificate/">Certificates, IDs, &amp; Profiles</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="https://feedbackassistant.apple.com/">Feedback Assistant</a></li> 

</ul> 
</div> 
</div> 


<div class="footer-directory-column"> 
<input class="footer-directory-column-section-state" 
type="checkbox" id="footer-directory-column-section-state-programs"> 
<div class="footer-directory-column-section"> 
<label class="footer-directory-column-section-label" 
for="footer-directory-column-section-state-programs"> 
<h3 class="footer-directory-column-section- 
title">Programs</h3> 
</label> 
<a href="#footer-directory-column-section-state-programs" 
class="footer-directory-column-section-anchor footer-directory-column-section- 
anchor-open"> <span class="footer-directory-column-section-anchor- 
label">Open Menu</span> </a> 
<a href="#" class="footer-directory-column-section-anchor 
footer-directory-column-section-anchor-close"> <span class="footer-directory- 
column-section-anchor-label">Close Menu</span> </a> 
<ul class="footer-directory-column-section-list"> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/programs/">Apple Developer 
Program</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/programs/enterprise/">Apple 
Developer Enterprise Program</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/app-store/small-business- 
program/">App Store Small Business Program</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="https://mfi.apple.com/">MFi 
Program</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/programs/news- 
partner/">News Partner Program</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/programs/video- 
partner/">Video Partner Program</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/security-bounty/">Security 
Bounty Program</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/programs/security-research- 
device/">Security Research Device Program</a></li> 


</ul> 
</div> 


<input class="footer-directory-column-section-state" 
type="checkbox" id="footer-directory-column-section-state-events"> 
<div class="footer-directory-column-section"> 
<label class="footer-directory-column-section-label" 
for="footer-directory-column-section-state-events"> 
<h3 class="footer-directory-column-section- 
title" >Events</h3> 
</label> 
<a href="#footer-directory-column-section-state-events" 
class="footer-directory-column-section-anchor footer-directory-column-section- 
anchor-open"> <span class="footer-directory-column-section-anchor- 
label">Open Menu</span> </a> 
<a href="#" class="footer-directory-column-section-anchor 
footer-directory-column-section-anchor-close"> <span class="footer-directory- 
column-section-anchor-label">Close Menu</span> </a> 
<ul class="footer-directory-column-section-list"> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/accelerator/">App 
Accelerators</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/app-store/app-store- 
awards/">App Store Awards</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/design/awards/">Apple 
Design Awards</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="/learn/experts/#academies">Apple Developer Academies</a></li> 
<li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/entrepreneur- 
camp/">Entrepreneur Camp</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/tech-talks/">Tech 
Talks</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/wwdc/">WWDC</a></li> 


</ul> 
</div> 
</div> 
<!--googleon: all--> 
</nav> 


<section class="footer-mini" vocab="http://schema.org/" 
typeof="Organization"> 
<div class="footer-mini-news"> 
<div class="copy"> 
To view the latest developer news, visit <a 
href="/news/">News and Updates</a>. 
</div> 
<div class="content"> 
<div class="color-scheme-toggle" role="radiogroup" 
tabindex="0" aria-label="Select a color scheme preference"> 


<label data-color-scheme-option="light"> 


<input type="radio" value="light" 
autocomplete="off" 
onchange="window.setPreferredColorScheme(event.target.value)"> 


<div class="text">Light</div> 
</label> 
<label data-color-scheme-option="dark"> 


<input type="radio" value="dark" 
autocomplete="off" 
onchange="window.setPreferredColorScheme(event.target.value)"> 


<div class="text">Dark</div> 
</label> 
<label data-color-scheme-option="auto"> 


<input type="radio" value="auto" 
autocomplete="off" 
onchange="window.setPreferredColorScheme(event.target.value)"> 


<div class="text">Auto</div> 
</label> 


</div> 
<script async="" src="/assets/scripts/color-scheme- 
toggle.js"></script> 
</div> 
</div> 
<link rel="stylesheet" href="/assets/styles/language-dropdown.css? 
41172203193"> 
<div class="language-dropdown dropdown-container" data- 
lang="complete"> 
<select class="dropdown" aria-label="Language 
Dropdown"><option 
value="https://developer.apple.com/augmented-reality/roomplan/">English</ 
option><option 
value="https://developer.apple.com/cn/augmented-reality/roomplan/" > 0000</ 
option><option 
value="https://developer.apple.com/jp/augmented-reality/roomplan/"> 0D00</ 
option><option 
value="https://developer.apple.com/kr/augmented-reality/roomplan/"> 000</ 
option></select> 
<span class="dropdown-icon icon icon-chevrondown" aria- 
hidden="true"></span> 
</div> 


<script async="" src="/assets/scripts/lib/jquery/jquery.language- 
dropdown.js?41172203193"></script> 
<div class="footer-mini-legal"> 
<div class="footer-mini-legal-copyright">Copyright © 2022 <a 
href="https://www.apple.com">Apple Inc.</a> All rights reserved.</div> 
<div class="footer-mini-legal-links"> 
<a class="footer-mini-legal-link" 
href="https://www.apple.com/legal/internet-services/terms/site.html">Terms of 
Use</a> 
<a class="footer-mini-legal-link" 
href="https://www.apple.com/legal/privacy/en-ww/">Privacy Policy</a> 
<a class="footer-mini-legal-link" 
href="/support/terms/">Agreements and Guidelines</a> 
</div> 
</div> 
</section> 
</div> 
</footer> 


<script src="/videos/scripts/hls/hls.min.js" ></script> 

<script src="/videos/scripts/hls/rtc.min.js"></script> 

<script src="/augmented-reality/roomplan/scripts/video.js" 
type="text/javascript" charset="utf-8"></script> 


</body></html> 
<html xmIns="https://www.w3.org/1999/xhtml" xml:lang="en" 
lang="en"><head> 
<meta charset="utf-8"> 
<meta name="Author" content="Apple Inc."> 
<meta name="viewport" content="width=device-width, initial-scale=1, 
viewport-fit=cover"> 
<link rel="shortcut icon" href="/favicon.ico"> 
<link rel="icon" href="/favicon.ico"> 
<link rel="mask-icon" href="/apple-logo.svg" color="#333333"> 


<link rel="stylesheet" href="/assets/styles/global.dist.css?41172203193" 
type="text/css"> 


<link rel="stylesheet" href="/assets/styles/localization.css?41172203193" 
type="text/css"> 


<script src="/assets/scripts/lib/jquery/jquery-3.6.0.min.js?41172203193"></ 
script> 

<script src="/assets/scripts/settings.js?41172203193"></script> 

<script src="/assets/scripts/language-locales.js?41172203193"></script> 
<script src="/assets/scripts/DeveloperBreadcrumbs.js?41172203193"></script> 


<script async="" src="/assets/scripts/lib/jquery/jquery.retinate.js? 
41172203193"></script> 

<script async="" src="/assets/scripts/global.js?41172203193"></script> 
<script async="" src="/assets/scripts/global-logout.js?41172203193"></script> 


<link rel="stylesheet" href="https://www.apple.com/wss/fonts? 
family=SF+Pro&amp;v=2" type="text/css"> 
<link rel="stylesheet" href="https://www.apple.com/wss/fonts? 
family=SF+Pro+lcons&amp;v=1" type="text/css"> 
<link rel="stylesheet" href="https://www.apple.com/wss/fonts? 
family=SF+Mono&amp;v=2" type="text/css"> 
<link rel="stylesheet" href="https://www.apple.com/wss/fonts? 
family=Apple+lcons&amp;v=1" type="text/css"> 


<title>Augmented Reality - Technologies - Human Interface Guidelines - 
Design - Apple Developer</title> 

<meta name="omni_page" content="Augmented Reality - Technologies - 
Human Interface Guidelines - Design - (English)"> 

<meta name="Description" content="Augmented reality (or AR) lets you 
deliver immersive, engaging experiences that seamlessly blend virtual objects 
with the real world."> 

<meta name="php check" content="4"> 


<meta name="search_thumbnail" content="/design/human- 
interface-guidelines/images/thumbnails/technologies/augmented-reality- 
thumbnail 2x.png"> 


<link rel="alternate" 
href="https://developer.apple.com/design/human-interface-guidelines/ 
technologies/augmented-reality/" hreflang="en"> 

<link rel="canonical" 
href="https://developer.apple.com/design/human-interface-guidelines/ 
technologies/augmented-reality/"> 


<script 
src="/design/human-interface-guidelines/scripts/application.js? 
58172205193&quot;&gt;"></script> 


<script src="/assets/scripts/lib/jquery/jquery.bxslider.min.js? 
41172203193&quot;&gt;"></script> 


<script src="/design/human-interface-guidelines/scripts/hig-nav.js? 
58172205193&quot;&gt;"></script> 


<script 
src="/design/human-interface-guidelines/scripts/darkModelmages.js? 
59202215202&quot;&gt;"></script> 


<link rel="stylesheet" type="text/css" 
href="/design/human-interface-guidelines/styles/application.css? 
14172206193 &quot;&gt;"> 


<link rel="stylesheet" type="text/css" href="/design/human-interface- 
guidelines/technologies/augmented-reality/styles/augmented-reality.css? 
15172206193 &quot;&gt;"> 


<link rel="stylesheet" type="text/css" href="/design/human-interface- 
guidelines/styles/human-interface-guidelines.css?01002216211&quot;&gt;"> 


<style type="text/css"> .helpers- 
module transition { 
transition-duration: 160ms; 
transition-timing-function: cubic-bezier(0.25, 0.46, 0.45, 0.94); 
}</style><style type="text/css">.SidenavLine line { 
position: absolute; 
top: 0; 
left: -1px; 
width: 1px; 
height: 25px; 
background: black; 
will-change: transform; 
transition-property: transform; 
} 


</style><style type="text/css">.Sidenavitem_children { 
margin: 0; 
Opacity: 0.6; 


.Sidenavltem link 4 

opacity: 0.6; 

padding: 0.2em 0; 
border-radius: 4px; 

color: #111; 

font-size: 14px; 

font-weight: 600; 

will-change: opacity; 
transition-property: opacity; 


„Sidenavltem children .Sidenavltem link 4 
font-weight: normal; 


„Sidenavltem active, 

„Sidenavltem link:hover 4 
opacity: 1; 
text-decoration: none; 


</style><style type="text/css"> 
.Sidenav_container 1 
position: sticky; 
position: -webkit-sticky; 
top: 52px; 
left: 100px; 
border-left: 1px solid #e3e3e3; 
padding: 0 18px; 
margin: 0 0 lem; 
} 
.Sidenav_container * { 
display: block; 


</style></head> 
<body data-hignav-item-name="" data-hignav-is-beta="false" id="technologies- 
augmented-reality" class="dmf " data-color-scheme="light"> 


<link rel="stylesheet" href="/assets/styles/globalnav.css?41172203193" 
type="text/css"> 


<link rel="stylesheet" href="/assets/styles/suggest-lang.css?41172203193" 
type="text/css"> 
<div id="suggest-lang" class="ribbon hide"> 
<div class="ribbon-content-wrapper"> 
<div class="ribbon-content row"> 
<div class="column large-12 large-centered"> 
<a id="suggest-closer" class="icon icon-after icon- 
reset"></a> 
<p><a href="#" id="suggest-link" class="ribbon-link 
more">View in English</a></p> 
</div> 
</div> 
</div> 
</div> 
<script src="/assets/scripts/suggest-lang.js?41172203193"></script> 
<aside id="ac-gn-segmentbar" class="ac-gn-segmentbar" lang="en-US" 
dir="ltr"> 
</aside> 
<input type="checkbox" id="ac-gn-menustate" class="ac-gn-menustate"> 
<nav id="ac-globalnav" class="js touch no-windows" role="navigation" aria- 
label="Global" data-hires="false" data-analytics-region="global nav" lang="en- 
US" dir="Itr" data-www-domain="www.apple.com" data-store-locale="us" data- 
store-root-path="/us" data-store-api="/[storefront]/shop/bag/status" data- 
search-locale="en_US" 
data-search-suggestions-api="/search-services/suggestions/" data-search- 
defaultlinks-api="/search-services/suggestions/defaultlinks/" data-search- 
suggestions-enabled="false"> 
<div class="ac-gn-content"> 
<ul class="ac-gn-header"> 
<li class="ac-gn-item ac-gn-menuicon"> 
<label class="ac-gn-menuicon-label" for="ac-gn- 
menustate" aria-hidden="true"> 
<span class="ac-gn-menuicon-bread ac-gn- 
menuicon-bread-top"> 
<span class="ac-gn-menuicon-bread- 
crust ac-gn-menuicon-bread-crust-top"></span> 
</span> 
<span class="ac-gn-menuicon-bread ac-gn- 
menuicon-bread-bottom"> 
<span class="ac-gn-menuicon-bread- 
crust ac-gn-menuicon-bread-crust-bottom"></span> 
</span> 
</label> 
<a href="#ac-gn-menustate" role="button" class="ac- 
gn-menuanchor ac-gn-menuanchor-open" id="ac-gn-menuanchor-open"> 
<span class="ac-gn-menuanchor-label">Global 
Nav Open Menu</span> 
</a> 
<a href="#" role="button" class="ac-gn-menuanchor 
ac-gn-menuanchor-close" id="ac-gn-menuanchor-close"> 


<span class="ac-gn-menuanchor-label">Global 
Nav Close Menu</span> 
</a> 
</li> 
<li class="ac-gn-item ac-gn-apple"> 
<a class="ac-gn-link ac-gn-link-apple-developer" 
href="/" data-analytics-title="appledeveloper home" id="ac-gn-firstfocus- 
small"> 
<span class="ac-gn-link-text">Apple 
Developer</span> 
</a> 
</li> 
</ul> 
<div class="ac-gn-search-placeholder-container" role="search"> 
<div class="ac-gn-search ac-gn-search-small"> 
<a id="ac-gn-link-search-small" class="ac-gn-link" 
href="/search/" data-analytics-title="search" data-analytics-click="search" data- 
analytics-intrapage-link="" aria-label="Search" role="button" aria- 
haspopup="true"> 
<div class="ac-gn-search-placeholder-bar"> 
<div class="ac-gn-search-placeholder- 
input" > 
<div class="ac-gn-search- 
placeholder-input-text" aria-hidden="true"> 
<div class="ac-gn-link- 
search ac-gn-search-placeholder-input-icon"></div> 
<span class="ac-gn-search- 
placeholder">Search</span> 
</div> 
</div> 
<div class="ac-gn-searchview-close ac- 
gn-searchview-close-small ac-gn-search-placeholder-searchview-close"> 
<span class="ac-gn-searchview- 
close-cancel" aria-hidden="true">Cancel</span> 
</div> 
</div> 
</a> 
</div> 
</div> 
<ul class="ac-gn-list"> 
<li class="ac-gn-item ac-gn-apple"> 
<a class="ac-gn-link ac-gn-link-apple-developer" 
href="/" data-analytics-title="appledeveloper home" id="ac-gn-firstfocus"> 
<span class="ac-gn-link-text">Apple 
Developer</span> 
</a> 
</li> 
<li class="ac-gn-item ac-gn-item-menu ac-gn-news"> 
<a class="ac-gn-link ac-gn-link-news" href="/news/" 
data-analytics-title="news"> 
<span class="ac-gn-link-text">News</span> 
</a> 
</li> 
<li class="ac-gn-item ac-gn-item-menu ac-gn-discover"> 


<a class="ac-gn-link ac-gn-link-discover" 
href="/discover/" data-analytics-title="discover"> 
<span 
class="ac-gn-link-text">Discover</span> 
</a> 
</li> 
<li class="ac-gn-item ac-gn-item-menu ac-gn-design"> 
<a class="ac-gn-link ac-gn-link-design" href="/design/" 
data-analytics-title="design"> 
<span class="ac-gn-link-text">Design</span> 
</a> 
</li> 
<li class="ac-gn-item ac-gn-item-menu ac-gn-develop"> 
<a class="ac-gn-link ac-gn-link-develop" 
href="/develop/" data-analytics-title="develop"> 
<span class="ac-gn-link-text">Develop</span> 
</a> 
</li> 
<li class="ac-gn-item ac-gn-item-menu ac-gn-distribute"> 
<a class="ac-gn-link ac-gn-link-distribute" 
href="/distribute/" data-analytics-title="distribute"> 
<span 
class="ac-gn-link-text">Distribute</span> 
</a> 
</li> 
<li class="ac-gn-item ac-gn-item-menu ac-gn-dsupport"> 
<a class="ac-gn-link ac-gn-link-dsupport" 
href="/support/" data-analytics-title="dsupport"> 
<span class="ac-gn-link-text" >Support</span> 
</a> 
</li> 
<li class="ac-gn-item ac-gn-item-menu ac-gn-account"> 
<a class="ac-gn-link ac-gn-link-account" 
href="/account/" data-analytics-title="account"> 
<span class="ac-gn-link-text">Account</span> 
</a> 
</li> 
<li class="ac-gn-item ac-gn-item-menu ac-gn-search" 
role="search"> 
<a id="ac-gn-link-search" class="ac-gn-link ac-gn-link- 
search" href="/search/" data-analytics-title="search" data-analytics- 
click="search" data-analytics-intrapage-link="" aria-label="Search" 
role="button" aria-haspopup="true"></a> 
</li> 
</ul> 
<aside id="ac-gn-searchview" class="ac-gn-searchview" 
role="search" data-analytics-region="search"> 
<div class="ac-gn-searchview-content"> 
<div class="ac-gn-searchview-bar"> 
<div class="ac-gn-searchview-bar-wrapper"> 
<form id="ac-gn-searchform" class="ac- 
gn-searchform" action="/search/" method="get"> 
<div class="ac-gn-searchform- 
wrapper"> 


<input id="ac-gn- 
searchform-input" class="ac-gn-searchform-input" type="text" name="q" aria- 
label="Search" placeholder="Search" autocorrect="off" autocapitalize="off" 
autocomplete="off" spellcheck="false" role="combobox" aria- 
autocomplete="list" aria-expanded="true" aria-owns="quicklinks suggestions"> 
<button id="ac-gn- 
searchform-submit" class="ac-gn-searchform-submit" type="submit" 
disabled="" aria-label="Submit Search"></button> 
<button id="ac-gn- 
searchform-reset" class="ac-gn-searchform-reset" type="reset" disabled="" 
aria-label="Clear Search"> 
<span 
class="ac-gn-searchform-reset-background"></span> 
</button> 
</div> 
<input type="hidden" id="search-hidden- 
input" value="HIG" name="group"></form> 
<button id="ac-gn-searchview-close- 
small" class="ac-gn-searchview-close ac-gn-searchview-close-small" aria- 
label="Cancel Search"> 
<span class="ac-gn- 
searchview-close-cancel" aria-hidden="true"> 
Cancel 
</span> 
</button> 
</div> 
</div> 
<aside id="ac-gn-searchresults" class="ac-gn- 
searchresults" data-string-quicklinks="Quick Links" data-string- 
suggestions="Suggested Searches" data-string-noresults=""> 
<section class="ac-gn-searchresults-section ac-gn-searchresults- 
section-defaultlinks"> 
<div class="ac-gn-searchresults-section-wrapper"> 
<div class="search-group- 
checkbox"><input id="group-input" type="checkbox" name="group-filter" 
checked="" value="HIG">Only search within “<span id="group-search- 
label">Human Interface Guidelines</span>"</div> 
<h3 class="ac-gn-searchresults-header ac-gn-searchresults- 
animated">Quick Links</h3> 
<ul class="ac-gn-searchresults-list" id="defaultlinks" 
role="listbox"> 
<li class="ac-gn-searchresults-item ac-gn-searchresults- 
animated"><a href="https://developer.apple.com/ios/" id="search-group-link-0" 
class="ac-gn-searchresults-link ac-gn-searchresults-link-defaultlinks">iOS 
16</a></li><li class="ac-gn-searchresults-item ac-gn-searchresults- 
animated"><a href="https://developer.apple.com/news/" id="search-group-link- 
1" class="ac-gn-searchresults-link ac-gn-searchresults-link-defaultlinks">Latest 
News</a></li><li class="ac-gn-searchresults-item ac-gn-searchresults- 
animated"><a 
href="https://developer.apple.com/documentation/storekit/appstore/ 
environment/3963900-xcode/" id="search-group-link-2" class="ac-gn- 
searchresults-link ac-gn-searchresults-link-defaultlinks">xcode</a></li><li 
class="ac-gn-searchresults-item ac-gn-searchresults-animated"><a 
href="https://developer.apple.com/xcode/whats-new/" id="search-group-link-3" 


class="ac-gn-searchresults-link ac-gn-searchresults-link-defaultlinks">What’s 
included in Xcode</a></li><li class="ac-gn-searchresults-item ac-gn- 
searchresults-animated"><a 
href="https://developer.apple.com/videos/play/wwdc2022/110345/" id="search- 
group-link-4" class="ac-gn-searchresults-link ac-gn-searchresults-link- 
defaultlinks">What’s new in Endpoint Security</a></li></ul> 
<span role="status" class="ac-gn-searchresults-count" aria- 
live="polite">5 Quick Links</span> 
</div> 
</section> 
</aside> 
</div> 
<button id="ac-gn-searchview-close" class="ac-gn- 
searchview-close" aria-label="Cancel Search"> 
<span class="ac-gn-searchview-close- 
wrapper"> 
<span class="ac-gn-searchview-close- 
left"></span> 
<span class="ac-gn-searchview-close- 
right"></span> 
</span> 
</button> 
</aside> 
</div> 
</nav> 
<div class="ac-gn-blur"></div> 
<div id="ac-gn-curtain" class="ac-gn-curtain"></div> 
<div id="ac-gn-placeholder" class="ac-nav-placeholder"></div> 
<script src="/assets/scripts/ac-globalnav.built.js?41172203193"></script><div 
id="ac-gn-viewport-emitter"> </div> 
<link rel="stylesheet" href="/assets/styles/search.css?41172203193"> 
<script src="/assets/scripts/search.js?41172203193"></script> 


<!-- metrics --> 
<script> 
/* RSID: */ 
var s account="awdappledeveloper" 
</script> 
<script src="/assets/metrics/scripts/analytics.js?10202020"></script> 
<script> 
s.pageName= AC && AC.Tracking && AC.Tracking.pageName(); 
s.channel="www.en.developer" 
s.channel="www.hig.developer"; 


peopecopocoraxx DO NOT ALTER ANYTHING BELOW THIS LINE ! Free / 
var ss code=s.t();if(s code)document.write(s code) 

</script> 

<!-- /metrics --> 


<link rel="stylesheet" property="stylesheet" 
href="/assets/styles/localnav.css" type="text/css"> 
<input type="checkbox" id="localnav-menustate" class="localnav-menustate"> 


<div id="localnav-sticky-placeholder" class="css-sticky 
localnav-sticking"></div><nav id="localnav" class="localnav localnav-scrim 
css-sticky localnav-sticking" data-sticky="" role="navigation"> 
<div class="localnav-wrapper"> 
<div class="localnav-background"></div> 
<div class="localnav-content"> 
<h2 class="localnav-title"> 
<a class="ac-In-title-logo" href="/design/" data-analytics- 
title="product index">Human Interface Guidelines</a> 
</h2> 


<div class="localnav-menu"> 
<a href="#localnav-menustate" class="localnav-menucta-anchor 
localnav-menucta-anchor-open" id="localnav-menustate-open"> 
<span class="localnav-menucta-anchor-label">Open Menu</span> 
</a> 
<a href="#" class="localnav-menucta-anchor localnav-menucta- 
anchor-close" id="localnav-menustate-close"> 
<span class="localnav-menucta-anchor-label">Close Menu</span> 
</a> 
<div class="localnav-menu-tray"> 
<div class="dn-container"> 
<nav id="dn-mobile" class="dn localnav- 
menu-items" role="navigation" aria-label="Local Navigation" data-hires="true"> 


<ul class="dn-list-container" 
style="max-height: 1760.5px; transition: max-height 0.2s ease-in-out 0s;"> 


«li class="dn-list-item"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-platforms"></span> 
<span class="dn-list-title">Platforms</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/platforms/overview"> 
<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-overview" 
data-hires-status="pending"></span> 


<span>Overview</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/platforms/designing-for-ios"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-designing-for-ios" data-hires- 
status="pending"></span> 
<span>Designing for ¡OS</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/platforms/designing-for-ipados"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-designing-for-ipados" data-hires- 
status="pending"></span> 
<span>Designing for iPadOS</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/platforms/designing-for-macos"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-designing-for-macos" data-hires- 
status="pending"></span> 
<span>Designing for macOS</span> 
</span> 


</a> 
</li> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/platforms/designing-for-tvos"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-designing-for-tvos" data-hires- 
status="pending"></span> 
<span>Designing for tvOS</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/platforms/designing-for-watchos"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-designing-for-watchos" data-hires- 
status="pending"></span> 


<span>Designing for watchOS</span> 


</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-foundations"></span> 
<span class="dn-list-title">Foundations</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/foundations/overview"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-overview" 
data-hires-status="pending"></span> 
<span>Overview</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/foundations/accessibility"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-accessibility" data-hires- 
status="pending"></span> 
<span>Accessibility</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/foundations/app-icons"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-app-icons" data-hires- 
status="pending"></span> 
<span>App icons</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/foundations/branding"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-branding" 
data-hires-status="pending"></span> 


<span>Branding</span> 


</li> 


<li class="dn-list-item"> 
href="/design/human-interface-guidelines/foundations/color"> 
class="dn-flex"> 


<span class="dn-icon dn-icon-color" 
data-hires-status="pending"></span> 
<span>Color</span> 


</li> 


<li class="dn-list-item"> 


</a> 


<a 


</a> 


<a 


href="/design/human-interface-guidelines/foundations/dark-mode"> 


class="dn-flex"> 


<span class="dn-icon dn-icon-dark-mode" data-hires- 
status="pending"></span> 


<span>Dark Mode</span> 


</li> 


<li class="dn-list-item"> 
href="/design/human-interface-guidelines/foundations/icons"> 
class="dn-flex"> 


<span class="dn-icon dn-icon-icons" 
data-hires-status="pending"></span> 


<span>Icons</span> 


</a> 


<a 


</span> 


<span 


</span> 


<span 


</span> 


<span 


</span> 


</li> 


<li class="dn-list-item"> 
href="/design/human-interface-guidelines/foundations/images"> 
class="dn-flex"> 


<span class="dn-icon dn-icon-images" 
data-hires-status="pending"></span> 
<span>Images</span> 


</li> 


<li class="dn-list-item"> 


</a> 


<a 


</a> 


<a 


href="/design/human-interface-guidelines/foundations/inclusion"> 


class="dn-flex"> 


<span class="dn-icon dn-icon-inclusion" 
data-hires-status="pending"></span> 


<span>Inclusion</span> 


</li> 


<li class="dn-list-item"> 
href="/design/human-interface-guidelines/foundations/layout"> 
class="dn-flex"> 


<span class="dn-icon dn-icon-layout" 
data-hires-status="pending"></span> 
<span>Layout</span> 


</li> 


<li class="dn-list-item"> 


</a> 


<a 


</a> 


<span 


</span> 


<span 


</span> 


<span 


</span> 


<a 
href="/design/human-interface-guidelines/foundations/materials"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-materials" data-hires- 
status="pending"></span> 
<span>Materials</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/foundations/motion"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-motion" 
data-hires-status="pending"></span> 
<span>Motion</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/foundations/right-to-left"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-right-to-left" data-hires- 
status="pending"></span> 
<span>Right to left</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/foundations/sf-symbols"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-sf-symbols" data-hires- 
status="pending"></span> 


<span>SF Symbols</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/foundations/typography"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-typography" data-hires- 
status="pending"></span> 
<span>Typography</span> 
</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-patterns"></span> 
<span class="dn-list-title">Patterns</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/overview"> 
<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-overview" 
data-hires-status="pending"></span> 


<span>Overview</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/accessing-private-data"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-accessing-private-data" data-hires- 
status="pending"></span> 


<span>Accessing private data</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/drag-and-drop"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-drag-and-drop" data-hires- 
status="pending"></span> 
<span>Drag and drop</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/entering-data"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-entering-data" data-hires- 
status="pending"></span> 
<span>Entering data</span> 
</span> 


</a> 
</li> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/patterns/feedback"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-feedback" 
data-hires-status="pending"></span> 
<span>Feedback</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/file-management"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-file-management" data-hires- 
status="pending"></span> 
<span>File management</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/going-full-screen"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-going-full-screen" data-hires- 
status="pending"></span> 
<span>Going full screen</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/patterns/launching"> 


<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-launching" data-hires- 
status="pending"></span> 


<span>Launching</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/live-viewing-apps"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-live-viewing-apps" data-hires- 
status="pending"></span> 
<span>Live-viewing apps</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/loading"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-loading" 
data-hires-status="pending"></span> 
<span>Loading</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/managing-accounts"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-managing-accounts" data-hires- 
status="pending"></span> 


<span>Managing accounts</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/managing-notifications"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-managing-notifications" data-hires- 
status="pending"></span> 


<span>Managing notifications</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/modality"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-modality" 
data-hires-status="pending"></span> 
<span>Modality</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/multitasking"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-multitasking" data-hires- 
status="pending"></span> 
<span>Multitasking</span> 
</span> 


</a> 
</li> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/patterns/offering-help"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-offering-help" data-hires- 
status="pending"></span> 
<span>Offering help</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/onboarding"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-onboarding" data-hires- 
status="pending"></span> 
<span>Onboarding</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/playing-audio"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-playing-audio" data-hires- 
status="pending"></span> 
<span>Playing audio</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/patterns/playing-haptics"> 


class="dn-flex"> 


<span class="dn-icon dn-icon-playing-haptics" data-hires- 
status="pending"></span> 
<span>Playing haptics</span> 


</li> 


«li class="dn-list-item"> 


</a> 


<a 


href="/design/human-interface-guidelines/patterns/playing-video"> 


class="dn-flex"> 


<span class="dn-icon dn-icon-playing-video" data-hires- 
status="pending"></span> 


<span>Playing video</span> 


</li> 


<li class="dn-list-item"> 
href="/design/human-interface-guidelines/patterns/printing"> 
class="dn-flex"> 


<span class="dn-icon dn-icon-printing" 
data-hires-status="pending"></span> 
<span>Printing</span> 


</li> 


<li class="dn-list-item"> 


</a> 


<a 


</a> 


<a 


<span 


</span> 


<span 


</span> 


<span 


</span> 


href="/design/human-interface-guidelines/patterns/ratings-and-reviews"> 


class="dn-flex"> 


<span class="dn-icon dn-icon-ratings-and-reviews" data-hires- 


status="pending"></span> 


<span 


<span>Ratings and reviews</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/searching"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-searching" data-hires- 
status="pending"></span> 
<span>Searching</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/settings"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-settings" 
data-hires-status="pending"></span> 
<span>Settings</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/undo-and-redo"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-undo-and-redo" data-hires- 
status="pending"></span> 
<span>Undo and redo</span> 
</span> 


</a> 
</li> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/patterns/workouts"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-workouts" 
data-hires-status="pending"></span> 
<span>Workouts</span> 
</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-components"></span> 
<span class="dn-list-title">Components</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item dn-list-item-link"> 


<a 
href="/design/human-interface-guidelines/components/all-components"> 


<span class="dn-flex"> 


<span class="dn-icon dn-icon-all-components" data-hires- 
status="pending"></span> 


<span>All components</span> 
</span> 


</a> 
</li> 


<li class="dn-list-item"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-content" 
data-hires-status="pending"></span> 
<span class="dn-list-title">Content</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/components/content/image-views"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-image-views"></span> 
<span>Image views</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/content/text-views"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-text-views"></span> 
<span>Text views</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/content/web-views"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-web-views"></span> 


<span>Web views</span> 
</span> 
</a> 
</li> 


</ul> 


</li> 


<li class="dn-list-item"> 
<span 
class="dn-flex"> 


«span class="dn-icon dn-icon-layout-and-organization" data-hires- 
status="pending"></span> 


<span class="dn-list-title">Layout and organization</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/layout-and-organization/ 
boxes"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-boxes"></span> 
<span>Boxes</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/layout-and-organization/ 
collections"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-collections"></span> 


<span>Collections</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/layout-and-organization/ 
column-views"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-column-views"></span> 
<span>Column views</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/layout-and-organization/ 
disclosure-controls"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-disclosure-controls"></span> 
<span>Disclosure controls</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/layout-and-organization/ 
labels"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-labels"></span> 
<span>Labels</span> 
</span> 


</a> 


</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/layout-and-organization/ 
lists-and-tables"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-lists-and-tables"></span> 
<span>Lists and tables</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/layout-and-organization/ 
lockups"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-lockups"></span> 
<span>Lockups</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/layout-and-organization/ 
outline-views"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-outline-views"></span> 
<span>Outline views</span> 
</span> 


</a> 
</li> 


«li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/components/layout-and-organization/ 
split-views"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-split-views"></span> 
<span>Split views</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/layout-and-organization/ 
tab-views"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-tab-views"></span> 
<span>Tab views</span> 
</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-menus-and-actions" data-hires- 
status="pending"></span> 
<span class="dn-list-title">Menus and actions</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/components/menus-and-actions/ 
activity-views"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-activity-views"></span> 
<span>Activity views</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/menus-and-actions/ 
buttons"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-buttons"></span> 
<span>Buttons</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/menus-and-actions/ 
context-menus"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-context-menus"></span> 
<span>Context menus</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/menus-and-actions/dock- 
menus"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-dock-menus"></span> 


<span>Dock menus</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/menus-and-actions/edit- 
menus"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-edit-menus"></span> 
<span>Edit menus</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/menus-and-actions/ 
menus"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-menus"></span> 
<span>Menus</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/menus-and-actions/pop- 
up-buttons"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-pop-up-buttons"></span> 
<span>Pop-up buttons</span> 
</span> 


</a> 


</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/menus-and-actions/pull- 
down-buttons"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-pull-down-buttons"></span> 
<span>Pull-down buttons</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/menus-and-actions/ 
toolbars"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-toolbars"></span> 
<span>Toolbars</span> 
</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-navigation-and-search" data-hires- 
status="pending"></span> 


<span class="dn-list-title">Navigation and search</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/navigation-and-search/ 
navigation-bars"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-navigation-bars"></span> 
<span>Navigation bars</span> 
</span> 


</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/navigation-and-search/ 
path-controls"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-path-controls"></span> 
<span>Path controls</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/navigation-and-search/ 
search-fields"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-search-fields"></span> 
<span>Search fields</span> 
</span> 


</a> 
</li> 


«li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/components/navigation-and-search/ 
sidebars"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-sidebars"></span> 
<span>Sidebars</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/navigation-and-search/ 
tab-bars"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-tab-bars"></span> 
<span>Tab bars</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/navigation-and-search/ 
token-fields"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-token-fields"></span> 
<span>Token fields</span> 
</span> 


</a> 
</li> 


</ul> 


</li> 


<li class="dn-list-item"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-presentation" data-hires- 
status="pending"></span> 
<span class="dn-list-title">Presentation</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/presentation/action- 
sheets"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-action-sheets"></span> 
<span>Action sheets</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/presentation/alerts"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-alerts"></span> 
<span>Alerts</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/presentation/page- 
controls"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-page-controls"></span> 


<span>Page controls</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/presentation/panels"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-panels"></span> 
<span>Panels</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/presentation/popovers"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-popovers"></span> 
<span>Popovers</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/presentation/scroll- 
views"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-scroll-views"></span> 
<span>Scroll views</span> 
</span> 


</a> 
</li> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/components/presentation/sheets"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-sheets"></span> 
<span>Sheets</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/presentation/windows"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-windows"></span> 
<span>Windows</span> 
</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-selection-and-input" data-hires- 
status="pending"></span> 
<span class="dn-list-title">Selection and input</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/components/selection-and-input/color- 
wells"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-color-wells"></span> 
<span>Color wells</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/selection-and-input/ 
combo-boxes"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-combo-boxes"></span> 
<span>Combo boxes</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/selection-and-input/digit- 
entry-views"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-digit-entry-views"></span> 
<span>Digit entry views</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/selection-and-input/ 
image-wells"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-image-wells"></span> 


<span>Image wells</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/selection-and-input/ 
onscreen-keyboards"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-onscreen-keyboards"></span> 
<span>Onscreen keyboards</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/selection-and-input/ 
pickers"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-pickers"></span> 
<span>Pickers</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/selection-and-input/ 
segmented-controls"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-segmented-controls"></span> 
<span>Segmented controls</span> 
</span> 


</a> 


</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/selection-and-input/ 
Sliders"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-sliders"></span> 
<span>Sliders</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/selection-and-input/ 
steppers"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-steppers"></span> 
<span>Steppers</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/selection-and-input/text- 
fields"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-text-fields"></span> 
<span>Text fields</span> 
</span> 


</a> 
</li> 


«li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/components/selection-and-input/ 
toggles"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-toggles"></span> 
<span>Toggles</span> 
</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-status" 
data-hires-status="pending"></span> 
<span class="dn-list-title">Status</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/components/status/activity-rings"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-activity-rings"></span> 
<span>Activity rings</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/status/level-indicators"> 


<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-level-indicators"></span> 


<span>Level indicators</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/status/progress- 
indicators"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-progress-indicators"></span> 
<span>Progress indicators</span> 
</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-system-experiences" data-hires- 
status="pending"></span> 
<span class="dn-list-title">System experiences</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/system-experiences/ 
complications"> 


<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-complications"></span> 


<span>Complications</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/system-experiences/ 
home-screen-quick-actions"> 
<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-home-screen-quick-actions"></span> 


<span>Home Screen quick actions</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/system-experiences/the- 
menu-bar"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-the-menu-bar"></span> 
<span>The menu bar</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/system-experiences/ 
notifications"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-notifications"></span> 


<span>Notifications</span> 


</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/system-experiences/ 
status-bars"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-status-bars"></span> 
<span>Status bars</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/system-experiences/top- 
shelf"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-top-shelf"></span> 
<span>Top Shelf</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/system-experiences/ 
watch-faces"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-watch-faces"></span> 
<span>Watch faces</span> 
</span> 


</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/system-experiences/ 
widgets"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-widgets"></span> 
<span>Widgets</span> 
</span> 
</a> 
</li> 
</ul> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-inputs"></span> 
<span class="dn-list-title">Inputs</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/overview"> 
<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-overview" 
data-hires-status="pending"></span> 


<span>Overview</span> 
</span> 


</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/apple-pencil-and-scribble"> 
<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-apple-pencil-and-scribble" data-hires- 
status="pending"></span> 


<span>Apple Pencil and Scribble</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/digital-crown"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-digital-crown" data-hires- 
status="pending"></span> 
<span>Digital Crown</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/focus-and-selection"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-focus-and-selection" data-hires- 
status="pending"></span> 
<span>Focus and selection</span> 
</span> 


</a> 
</li> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/inputs/game-controllers"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-game-controllers" data-hires- 
status="pending"></span> 


<span>Game controllers</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/gyro-and-accelerometer"> 
<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-gyro-and-accelerometer" data-hires- 
status="pending"></span> 


<span>Gyro and accelerometer</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/keyboards"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-keyboards" data-hires- 
status="pending"></span> 
<span>Keyboards</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/pointing-devices"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-pointing-devices" data-hires- 
status="pending"></span> 


<span>Pointing devices</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/remotes"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-remotes" 
data-hires-status="pending"></span> 
<span>Remotes</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/spatial-interactions"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-spatial-interactions" data-hires- 
status="pending"></span> 
<span>Spatial interactions</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/touch-bar"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-touch-bar" data-hires- 
status="pending"></span> 
<span>Touch Bar</span> 
</span> 


</a> 


</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/touchscreen-gestures"> 
<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-touchscreen-gestures" data-hires- 
status="pending"></span> 


<span>Touchscreen gestures</span> 
</span> 
</a> 
</li> 


</ul> 


</li> 


<li class="dn-list-item dn-icon--active"> 
<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-technologies dn-list-item--active dn-icon-- 
active"></span> 


<span class="dn-list-title dn-list-item--active dn-icon-- 
active">Technologies</span> 
</span> 
<ul class="dn-list-container dn-- 


expanded" style="position: relative; visibility: unset; max-height: 955px; 
transition: max-height 0.2s ease-in-out Os;"> 


<li class="dn-list-item dn-list-item-link"> 


<a 
href="/design/human-interface-guidelines/technologies/all-technologies"> 


<span class="dn-flex"> 


<span class="dn-icon dn-icon-all-technologies" data-hires- 
status="pending"></span> 


<span>All technologies</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-airplay" 
data-hires-status="pending"></span> 
<span class="dn-list-title">AirPlay</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/technologies/airplay/introduction"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-introduction"></span> 
<span>Introduction</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/airplay/icons"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-icons" 
data-hires-status="pending"></span> 
<span>Icons</span> 
</span> 
</a> 


</li> 


<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/airplay/editorial"> 


class="dn-flex"> 
<span class="dn-icon dn-icon-editorial"></span> 
<span>Editorial</span> 
</a> 
</li> 
</ul> 


</li> 


<li class="dn-list-item dn-list-item-link"> 


href="/design/human-interface-guidelines/technologies/always-on"> 
<span class="dn-flex"> 


<span class="dn-icon dn-icon-always-on" data-hires- 
status="pending"></span> 


<span>Always On</span> 
</span> 


</li> 


<li class="dn-list-item"> 
class="dn-flex"> 


<span class="dn-icon dn-icon-app-clips" 
data-hires-status="pending"></span> 


<span class="dn-list-title">App Clips</span> 


<span 


</span> 


<a 


</a> 


<span 


</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/technologies/app-clips/introduction"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-introduction"></span> 
<span>Introduction</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/app-clips/experience"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-experience"></span> 
<span>User experience</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/app-clips/app-clip-card"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-app-clip-card"></span> 
<span>App Clip card</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/app-clips/app-clip- 
codes"> 


<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-app-clip-codes"></span> 


<span>App Clip Codes</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/app-clips/printing- 
guidelines"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-printing-guidelines"></span> 
<span>Printing guidelines</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/app-clips/legal- 
requirements"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-legal-requirements"></span> 
<span>Legal requirements</span> 
</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-apple-pay" data-hires- 
status="pending"></span> 


<span class="dn-list-title">Apple Pay</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/technologies/apple-pay/introduction"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-introduction"></span> 
<span>Introduction</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/apple-pay/offering-apple- 
pay"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-offering-apple-pay"></span> 
<span>Offering Apple Pay</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/apple-pay/checkout-and- 
payment"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-checkout-and-payment"></span> 
<span>Checkout and payment</span> 


</span> 
</a> 


</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/apple-pay/handling- 
errors"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-handling-errors"></span> 
<span>Error handling</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/apple-pay/subscriptions- 
and-donations"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-subscriptions-and-donations"></span> 


<span>Subscriptions and donations</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/apple-pay/buttons-and- 
marks"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-buttons-and-marks"></span> 
<span>Buttons and marks</span> 
</span> 


</a> 
</li> 


«li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/technologies/apple-pay/editorial- 
guidelines"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-editorial-guidelines"></span> 
<span>Editorial</span> 
</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item dn-list-item-link dn-list-item--active"> 
<a 


href="/design/human-interface-guidelines/technologies/augmented-reality"> 
<span class="dn-flex"> 


<span class="dn-icon dn-icon-augmented-reality" data-hires- 
status="pending"></span> 


<span>Augmented reality</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-carekit" 
data-hires-status="pending"></span> 
<span class="dn-list-title">CareKit</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/technologies/carekit/introduction"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-introduction"></span> 
<span>Introduction</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/carekit/data-and- 
privacy"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-data-and-privacy"></span> 
<span>Data and privacy</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/carekit/views"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-views"></span> 
<span>Views</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/carekit/user- 
experience"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-user-experience"></span> 


<span>User experience</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/carekit/symbols-and- 
branding"> 
<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-symbols-and-branding"></span> 


<span>Symbols and branding</span> 


</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-carplay" 
data-hires-status="pending"></span> 
<span class="dn-list-title">CarPlay</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/carplay/introduction"> 
<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-introduction"></span> 


<span>Introduction</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/carplay/architecture"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-architecture"></span> 
<span>Architecture</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/carplay/interaction"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-interaction"></span> 
<span>Interaction</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/carplay/visual-design"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-visual-design"></span> 
<span>Visual design</span> 
</span> 
</a> 


</li> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/technologies/carplay/icons-and- 
images"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-icons-and-images"></span> 
<span>Icons and images</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/carplay/system- 
elements"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-system-elements"></span> 
<span>System elements</span> 
</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-game-center" data-hires- 
status="pending"></span> 
<span class="dn-list-title">Game Center</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/technologies/game-center/ 
introduction"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-introduction"></span> 
<span>Introduction</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/game-center/access- 
point"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-access-point"></span> 
<span>Access point</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/game-center/ 
dashboard"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-dashboard"></span> 
<span>Dashboard</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/game-center/ 
achievements"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-achievements"></span> 


<span>Achievements</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/game-center/ 
leaderboards"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-leaderboards"></span> 
<span>Leaderboards</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/game-center/ 
multiplayer"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-multiplayer"></span> 
<span>Multiplayer</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/game-center/custom- 
dashboard-links"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-custom-dashboard-links"></span> 


<span>Custom dashboard links</span> 
</span> 


</a> 


</li> 


</ul> 


</li> 


<li class="dn-list-item dn-list-item-link"> 


href="/design/human-interface-guidelines/technologies/healthkit"> 
<span class="dn-flex"> 


<span class="dn-icon dn-icon-healthkit" 
data-hires-status="pending"></span> 


<span>HealthKit</span> 
</span> 


</li> 


<li class="dn-list-item"> 
class="dn-flex"> 


<span class="dn-icon dn-icon-homekit" 
data-hires-status="pending"></span> 


<span class="dn-list-title">HomekKit</span> 


<a 


</a> 


<span 


</span> 


<ul class="dn-list-container" 


style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/homekit/introduction"> 


class="dn-flex"> 
<span class="dn-icon dn-icon-introduction"></span> 


<span>Introduction</span> 


<span 


</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/homekit/terminology- 
and-layout"> 
<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-terminology-and-layout"></span> 


<span>Terminology and layout</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/homekit/setup"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-setup"></span> 
<span>Setup</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/homekit/siri- 
interactions"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-siri-interactions"></span> 
<span>Siri interactions</span> 
</span> 


</a> 
</li> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/technologies/homekit/custom- 
functionality"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-custom-functionality"></span> 
<span>Custom functionality </span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/homekit/icons"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-icons" 
data-hires-status="pending"></span> 
<span>Icons</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/homekit/editorial"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-editorial"></span> 
<span>Editorial</span> 
</span> 
</a> 
</li> 


</ul> 


</li> 


<li class="dn-list-item dn-list-item-link"> 


<a 
href="/design/human-interface-guidelines/technologies/icloud"> 
<span class="dn-flex"> 
<span class="dn-icon dn-icon-icloud" 
data-hires-status="pending"></span> 
<span>iCloud</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-in-app-purchase" data-hires- 
status="pending"></span> 
<span class="dn-list-title">In-app purchase</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/in-app-purchase/ 
introduction"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-introduction"></span> 
<span>Introduction</span> 
</span> 


</a> 
</li> 


«li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/technologies/in-app-purchase/auto- 
renewable-subscriptions"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-auto-renewable-subscriptions"></span> 
<span>Auto-renewable subscriptions</span> 
</span> 
</a> 
</li> 


</ul> 


</li> 


<li class="dn-list-item dn-list-item-link"> 


<a 
href="/design/human-interface-guidelines/technologies/live-photos"> 


<span class="dn-flex"> 


<span class="dn-icon dn-icon-live-photos" data-hires- 
status="pending"></span> 


<span>Live Photos</span> 


</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-mac-catalyst" data-hires- 
status="pending"></span> 


<span class="dn-list-title">Mac Catalyst</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/mac-catalyst/ 
introduction"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-introduction"></span> 
<span>Introduction</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/mac-catalyst/app- 
structure" > 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-app-structure"></span> 
<span>App structure</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/mac-catalyst/user- 
interaction"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-user-interaction"></span> 
<span>User interaction</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/mac-catalyst/visual- 
design"> 


<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-visual-design"></span> 


<span>Visual design</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/mac-catalyst/mac- 
idiom"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-mac-idiom"></span> 
<span>Mac idiom</span> 
</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-machine-learning" data-hires- 
status="pending"></span> 
<span class="dn-list-title">Machine learning</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/machine-learning/ 
introduction"> 


<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-introduction"></span> 


<span>Introduction</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/machine-learning/roles"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-roles"></span> 
<span>Machine learning roles</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/machine-learning/ 
explicit-feedback"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-explicit-feedback"></span> 
<span>Explicit feedback</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/machine-learning/ 
implicit-feedback"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-implicit-feedback"></span> 


<span>Implicit feedback</span> 
</span> 


<li class="dn-list-item"> 


</a> 


<a 


href="/design/human-interface-guidelines/technologies/machine-learning/ 


calibration"> 


class="dn-flex"> 
<span class="dn-icon dn-icon-calibration"></span> 


<span>Calibration</span> 


<li class="dn-list-item"> 


<span 


</span> 
</a> 


<a 


href="/design/human-interface-guidelines/technologies/machine-learning/ 


corrections" > 


class="dn-flex"> 
<span class="dn-icon dn-icon-corrections"></span> 


<span>Corrections</span> 


«li class="dn-list-item"> 


<span 


</span> 
</a> 


<a 


href="/design/human-interface-guidelines/technologies/machine-learning/ 


mistakes"> 


class="dn-flex"> 
<span class="dn-icon dn-icon-mistakes"></span> 


<span>Mistakes</span> 


<li class="dn-list-item"> 


<span 


</span> 
</a> 


<a 


href="/design/human-interface-guidelines/technologies/machine-learning/ 


multiple-options"> 
class="dn-flex"> 
<span class="dn-icon dn-icon-multiple-options"></span> 


<span>Multiple options</span> 


<li class="dn-list-item"> 


<span 


</span> 
</a> 


<a 


href="/design/human-interface-guidelines/technologies/machine-learning/ 


confidence"> 


class="dn-flex"> 
<span class="dn-icon dn-icon-confidence"></span> 


<span>Confidence</span> 


<li class="dn-list-item"> 


<span 


</span> 
</a> 


<a 


href="/design/human-interface-guidelines/technologies/machine-learning/ 


attribution"> 


class="dn-flex"> 
<span class="dn-icon dn-icon-attribution"></span> 


<span>Attribution</span> 


<li class="dn-list-item"> 


<span 


</span> 
</a> 


<a 


href="/design/human-interface-guidelines/technologies/machine-learning/ 


limitations"> 


class="dn-flex"> 


<span 


<span class="dn-icon dn-icon-limitations"></span> 


<span>Limitations</span> 


</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-maps" 
data-hires-status="pending"></span> 
<span class="dn-list-title">Maps</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/technologies/maps/introduction"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-introduction"></span> 
<span>Introduction</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/maps/apple-watch- 
maps"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-apple-watch-maps"></span> 


<span>Apple Watch maps</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/maps/indoor-maps"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-indoor-maps"></span> 
<span>Indoor maps</span> 
</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-messages-for-business" data-hires- 
status="pending"></span> 
<span class="dn-list-title">Messages for Business</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/messages-for-business/ 
introduction"> 
<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-introduction"></span> 


<span>Introduction</span> 


</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/messages-for-business/ 
branding"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-branding" 
data-hires-status="pending"></span> 
<span>Branding</span> 
</span> 
</a> 


</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/messages-for-business/ 
buttons"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-buttons"></span> 
<span>Buttons</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/messages-for-business/ 
color"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-color" 
data-hires-status="pending"></span> 
<span>Color</span> 
</span> 


</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/messages-for-business/ 
dark-mode"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-dark-mode" data-hires- 
status="pending"></span> 
<span>Dark Mode</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/messages-for-business/ 
logo"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-logo"></span> 
<span>Logo</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/messages-for-business/ 
message-bubble-content"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-message-bubble-content"></span> 
<span>Message bubble content</span> 
</span> 


</a> 
</li> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/technologies/messages-for-business/ 
screenshots"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-screenshots"></span> 
<span>Screenshots</span> 
</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item dn-list-item-link"> 
<a 


href="/design/human-interface-guidelines/technologies/nfc"> 
<span class="dn-flex"> 


<span class="dn-icon dn-icon-nfc" data-hires-status="pending"> </span> 


<span>NFC</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item dn-list-item-link"> 
<a 


href="/design/human-interface-guidelines/technologies/photo-editing"> 
<span class="dn-flex"> 


<span class="dn-icon dn-icon-photo-editing" data-hires- 
status="pending"></span> 


<span>Photo editing</span> 


</span> 


</li> 


<li class="dn-list-item dn-list-item-link"> 


href="/design/human-interface-guidelines/technologies/researchkit"> 
<span class="dn-flex"> 


<span class="dn-icon dn-icon-researchkit" data-hires- 
status="pending"></span> 


<span>ResearchKit</span> 
</span> 


</li> 


<li class="dn-list-item dn-list-item-link"> 


href="/design/human-interface-guidelines/technologies/shareplay"> 
<span class="dn-flex"> 


<span class="dn-icon dn-icon-shareplay" data-hires- 
status="pending"></span> 


<span>SharePlay</span> 
</span> 


</li> 


<li class="dn-list-item dn-list-item-link"> 


href="/design/human-interface-guidelines/technologies/shazamkit"> 


<span class="dn-flex"> 


</a> 


<a 


</a> 


<a 


</a> 


<a 


<span class="dn-icon dn-icon-shazamkit" data-hires- 
status="pending"></span> 


<span>ShazamKit</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-sign-in-with-apple" data-hires- 
status="pending"></span> 
<span class="dn-list-title">Sign in with Apple</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/sign-in-with-apple/ 
introduction"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-introduction"></span> 
<span>Introduction</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/sign-in-with-apple/data- 
management"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-data-management"></span> 


<span>Data management</span> 
</span> 


</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/sign-in-with-apple/ 
buttons"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-buttons"></span> 
<span>Buttons</span> 
</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 


class="dn-flex"> 
<span class="dn-icon dn-icon-siri" data-hires-status="pending"></span> 


<span class="dn-list-title">Siri</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/technologies/siri/introduction"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-introduction"></span> 
<span>Introduction</span> 
</span> 
</a> 


</li> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/technologies/siri/system-intents"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-system-intents"></span> 
<span>System intents</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/siri/custom-intents"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-custom-intents"></span> 
<span>Custom intents</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/siri/shortcuts-and- 
suggestions"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-shortcuts-and-suggestions"></span> 


<span>Shortcuts and suggestions</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/siri/editorial-guidelines"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-editorial-guidelines"></span> 
<span>Editorial</span> 
</span> 
</a> 
</li> 


</ul> 


</li> 


<li class="dn-list-item dn-list-item-link"> 


<a 
href="/design/human-interface-guidelines/technologies/tap-to-pay-on-iphone"> 


<span class="dn-flex"> 


<span class="dn-icon dn-icon-tap-to-pay-on-iphone" data-hires- 
status="pending"></span> 


<span>Tap to Pay on iPhone</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-wallet" 
data-hires-status="pending"></span> 
<span class="dn-list-title">Wallet</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/wallet/introduction"> 


<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-introduction"></span> 


<span>Introduction</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/wallet/designing- 
passes"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-designing-passes"></span> 
<span>Designing passes</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/wallet/designing-order- 
tracking"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-designing-order-tracking"></span> 
<span>Designing order tracking</span> 
</span> 
</a> 
</li> 


</ul> 


</li> 


</ul> 


</li> 


</ul> 


</nav> 
</div> 
<ul class="localnav-menu-items"> 
<li class="localnav-menu-item"> 
<a href="/design/" class="localnav-menu-link">Overview</a> 
</li> 
<li class="localnav-menu-item"> 
<a href="/design/whats-new/" class="localnav-menu- 
link">What's New</a> 
</li> 
<li class="localnav-menu-item"> 
<a 
href="/design/human-interface-guidelines/guidelines/overview" class="localnav- 
menu-link">Guidelines</a> 
</li> 
<li class="localnav-menu-item"> 
<a href="/design/awards/" class="localnav-menu-link">Design 
Awards</a> 
</li> 
<li class="localnav-menu-item"> 
<a href="/videos/design/" class="localnav-menu- 
link">Videos</a> 
</li> 
<li class="localnav-menu-item"> 
<a href="/design/resources/" class="localnav-menu- 
link">Resources</a> 
</li> 
</ul> 
</div> 
<div class="localnav-actions"> 
<div class="localnav-action localnav-action-menucta" aria- 
hidden="true"> 
<label for="localnav-menustate" class="localnav-menucta"> 
<span class="localnav-menucta-chevron"></span> 
</label> 
</div> 
</div> 


</div> 
</div> 
</div> 
</nav> 
<label id="localnav-curtain" for="localnav-menustate"></label> 
<script src="/assets/scripts/ac-localnav.built.js"></script><div id="localnav- 
viewport-emitter" data-viewport-emitter-dispatch="" data-viewport-emitter- 
state="{ &quot;viewport&quot;:&quot;small&quot;, &quot;orientation&quot;:&quo 
t;portrait&quot;,&quot;retina&quot;:true}"></div> 
<script type="text/javascript" src="/assets/scripts/localnav.js"></script> 


<main id="main" class="main main-hig" role="main"> 


<!-- HIG content --> 
<section class="section section-hig-container" id="section-hig- 


container"> 
<div id="grid-spacer"></div> 
<div class="section-content"> 
<div class="row row-hig-container" id="row-hig- 
container"> 


<!-- Side navigation --> 
<div class="column dn-container small-hide" 
style="align-self: flex-start;"> 
<nav id="dn" class="dn" 
role="navigation" aria-label="Local Navigation" data-hires="true"> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-platforms"></span> 
<span class="dn-list-title">Platforms</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/platforms/overview"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-overview" 
data-hires-status="pending"></span> 
<span>Overview</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/platforms/designing-for-ios"> 


<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-designing-for-ios" data-hires- 
status="pending"></span> 


<span>Designing for ¡OS</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/platforms/designing-for-ipados"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-designing-for-ipados" data-hires- 
status="pending"></span> 
<span>Designing for iPadOS</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/platforms/designing-for-macos"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-designing-for-macos" data-hires- 
status="pending"></span> 
<span>Designing for macOS</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/platforms/designing-for-tvos"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-designing-for-tvos" data-hires- 
status="pending"></span> 


<span>Designing for tvOS</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/platforms/designing-for-watchos"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-designing-for-watchos" data-hires- 
status="pending"></span> 


<span>Designing for watchOS</span> 


</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-foundations"></span> 
<span class="dn-list-title">Foundations</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/foundations/overview"> 
<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-overview" 
data-hires-status="pending"></span> 


<span>Overview</span> 


<li class="dn-list-item"> 


</li> 


</a> 


<a 


href="/design/human-interface-guidelines/foundations/accessibility"> 


class="dn-flex"> 


<span class="dn-icon dn-icon-accessibility" data-hires- 


status="pending"></span> 


<span>Accessibility</span> 


<li class="dn-list-item"> 


</li> 


</a> 


<a 


href="/design/human-interface-guidelines/foundations/app-icons"> 


class="dn-flex"> 


<span class="dn-icon dn-icon-app-icons" data-hires- 


status="pending"></span> 


<span>App icons</span> 


<li class="dn-list-item"> 


</li> 


</a> 


<a 


href="/design/human-interface-guidelines/foundations/branding"> 


class="dn-flex"> 


<span class="dn-icon dn-icon-branding" 
data-hires-status="pending"></span> 


<span>Branding</span> 


</li> 


</a> 


</span> 


<span 


</span> 


<span 


</span> 


<span 


</span> 


<li class="dn-list-item"> 
href="/design/human-interface-guidelines/foundations/color"> 
class="dn-flex"> 


<span class="dn-icon dn-icon-color" 
data-hires-status="pending"></span> 
<span>Color</span> 


</li> 


<li class="dn-list-item"> 


<a 


</a> 


<a 


href="/design/human-interface-guidelines/foundations/dark-mode"> 


class="dn-flex"> 


<span class="dn-icon dn-icon-dark-mode" data-hires- 
status="pending"></span> 


<span>Dark Mode</span> 


</li> 


<li class="dn-list-item"> 
href="/design/human-interface-guidelines/foundations/icons"> 
class="dn-flex"> 


<span class="dn-icon dn-icon-icons" 
data-hires-status="pending"></span> 


<span>Icons</span> 


</li> 


<li class="dn-list-item"> 


href="/design/human-interface-guidelines/foundations/images"> 


class="dn-flex"> 


</a> 


<a 


</a> 


<a 


<span 


</span> 


<span 


</span> 


<span 


</span> 


<span 


<span class="dn-icon dn-icon-images" 
data-hires-status="pending"></span> 


<span>Images</span> 


</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/foundations/inclusion"> 
class="dn-flex"> 


<span class="dn-icon dn-icon-inclusion" 
data-hires-status="pending"></span> 


<span>Inclusion</span> 


</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/foundations/layout"> 
class="dn-flex"> 
<span class="dn-icon dn-icon-layout" 
data-hires-status="pending"></span> 
<span>Layout</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/foundations/materials"> 
class="dn-flex"> 


<span class="dn-icon dn-icon-materials" data-hires- 
status="pending"></span> 


<span>Materials</span> 


</span> 


<span 


</span> 


<span 


</span> 


<span 


</span> 


</a> 
</li> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/foundations/motion"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-motion" 
data-hires-status="pending"></span> 
<span>Motion</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/foundations/right-to-left"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-right-to-left" data-hires- 
status="pending"></span> 
<span>Right to left</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/foundations/sf-symbols"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-sf-symbols" data-hires- 
status="pending"></span> 
<span>SF Symbols</span> 
</span> 


</a> 
</li> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/foundations/typography"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-typography" data-hires- 
status="pending"></span> 
<span>Typography</span> 
</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-patterns"></span> 
<span class="dn-list-title">Patterns</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/patterns/overview"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-overview" 
data-hires-status="pending"></span> 
<span>Overview</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/patterns/accessing-private-data"> 


<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-accessing-private-data" data-hires- 
status="pending"></span> 


<span>Accessing private data</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/drag-and-drop"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-drag-and-drop" data-hires- 
status="pending"></span> 
<span>Drag and drop</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/entering-data"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-entering-data" data-hires- 
status="pending"></span> 
<span>Entering data</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/feedback"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-feedback" 
data-hires-status="pending"></span> 


<span>Feedback</span> 


<li class="dn-list-item"> 


href="/design/human-interface-guidelines/patterns/file-management"> 


class="dn-flex"> 


</li> 


</a> 


<a 


<span class="dn-icon dn-icon-file-management" data-hires- 


status="pending"></span> 


<span>File management</span> 


«li class="dn-list-item"> 


href="/design/human-interface-guidelines/patterns/going-full-screen"> 


class="dn-flex"> 


</li> 


</a> 


<a 


<span class="dn-icon dn-icon-going-full-screen" data-hires- 


status="pending"></span> 


<span>Going full screen</span> 


<li class="dn-list-item"> 


href="/design/human-interface-guidelines/patterns/launching"> 


class="dn-flex"> 


</li> 


<span class="dn-icon dn-icon-launching" data-hires- 


status="pending"></span> 


<span>Launching</span> 


</li> 


</a> 


<a 


</a> 


</span> 


<span 


</span> 


<span 


</span> 


<span 


</span> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/patterns/live-viewing-apps"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-live-viewing-apps" data-hires- 
status="pending"></span> 
<span>Live-viewing apps</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/loading"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-loading" 
data-hires-status="pending"></span> 
<span>Loading</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/managing-accounts"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-managing-accounts" data-hires- 
status="pending"></span> 
<span>Managing accounts</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/patterns/managing-notifications"> 


class="dn-flex"> 


<span 


<span class="dn-icon dn-icon-managing-notifications" data-hires- 


status="pending"></span> 


<span>Managing notifications</span> 


</li> 


<li class="dn-list-item"> 
href="/design/human-interface-guidelines/patterns/modality"> 
class="dn-flex"> 


<span class="dn-icon dn-icon-modality" 
data-hires-status="pending"></span> 
<span>Modality</span> 


</li> 


<li class="dn-list-item"> 


</a> 


<a 


</a> 


<a 


href="/design/human-interface-guidelines/patterns/multitasking"> 


class="dn-flex"> 


<span class="dn-icon dn-icon-multitasking" data-hires- 
status="pending"></span> 
<span>Multitasking</span> 


</li> 


<li class="dn-list-item"> 


</a> 


<a 


href="/design/human-interface-guidelines/patterns/offering-help"> 


class="dn-flex"> 


<span class="dn-icon dn-icon-offering-help" data-hires- 
status="pending"></span> 


</span> 


<span 


</span> 


<span 


</span> 


<span 


<span>Offering help</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/onboarding"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-onboarding" data-hires- 
status="pending"></span> 
<span>Onboarding</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/playing-audio"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-playing-audio" data-hires- 
status="pending"></span> 
<span>Playing audio</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/playing-haptics"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-playing-haptics" data-hires- 
status="pending"></span> 
<span>Playing haptics</span> 
</span> 


</a> 
</li> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/patterns/playing-video"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-playing-video" data-hires- 
status="pending"></span> 
<span>Playing video</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/printing"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-printing" 
data-hires-status="pending"></span> 
<span>Printing</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/ratings-and-reviews"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-ratings-and-reviews" data-hires- 
status="pending"></span> 
<span>Ratings and reviews</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/patterns/searching"> 


class="dn-flex"> 


<span class="dn-icon dn-icon-searching" data-hires- 
status="pending"></span> 


<span>Searching</span> 


</li> 


<li class="dn-list-item"> 
href="/design/human-interface-guidelines/patterns/settings"> 
class="dn-flex"> 


<span class="dn-icon dn-icon-settings" 
data-hires-status="pending"></span> 
<span>Settings</span> 


</li> 


<li class="dn-list-item"> 


</a> 


<a 


</a> 


<a 


href="/design/human-interface-guidelines/patterns/undo-and-redo"> 


class="dn-flex"> 


<span class="dn-icon dn-icon-undo-and-redo" data-hires- 
status="pending"></span> 


<span>Undo and redo</span> 


</li> 


<li class="dn-list-item"> 
href="/design/human-interface-guidelines/patterns/workouts"> 
class="dn-flex"> 


<span class="dn-icon dn-icon-workouts" 
data-hires-status="pending"></span> 


</a> 


<a 


<span 


</span> 


<span 


</span> 


<span 


</span> 


<span 


<span>Workouts</span> 


</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-components"></span> 
<span class="dn-list-title">Components</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item dn-list-item-link"> 


<a 
href="/design/human-interface-guidelines/components/all-components"> 


<span class="dn-flex"> 


<span class="dn-icon dn-icon-all-components" data-hires- 
status="pending"></span> 


<span>All components</span> 


</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-content" 
data-hires-status="pending"></span> 


<span class="dn-list-title">Content</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/components/content/image-views"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-image-views"></span> 
<span>Image views</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/content/text-views"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-text-views"></span> 
<span>Text views</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/content/web-views"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-web-views"></span> 
<span>Web views</span> 
</span> 
</a> 


</li> 


</ul> 


</li> 


<li class="dn-list-item"> 
<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-layout-and-organization" data-hires- 
status="pending"></span> 


<span class="dn-list-title">Layout and organization</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/layout-and-organization/ 
boxes"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-boxes"></span> 
<span>Boxes</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/layout-and-organization/ 
collections"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-collections"></span> 
<span>Collections</span> 
</span> 


</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/layout-and-organization/ 
column-views"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-column-views"></span> 
<span>Column views</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/layout-and-organization/ 
disclosure-controls"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-disclosure-controls"></span> 
<span>Disclosure controls</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/layout-and-organization/ 
labels"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-labels"></span> 
<span>Labels</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/layout-and-organization/ 
lists-and-tables"> 


<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-lists-and-tables"></span> 


<span>Lists and tables</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/layout-and-organization/ 
lockups"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-lockups"></span> 
<span>Lockups</span> 
</span> 
</a> 


</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/layout-and-organization/ 
outline-views"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-outline-views"></span> 
<span>Outline views</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/layout-and-organization/ 
split-views"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-split-views"></span> 


<span>Split views</span> 


</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/layout-and-organization/ 
tab-views"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-tab-views"></span> 
<span>Tab views</span> 
</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-menus-and-actions" data-hires- 
status="pending"></span> 
<span class="dn-list-title">Menus and actions</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/menus-and-actions/ 
activity-views"> 
<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-activity-views"></span> 


<span>Activity views</span> 
</span> 


</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/menus-and-actions/ 
buttons"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-buttons"></span> 
<span>Buttons</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/menus-and-actions/ 
context-menus"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-context-menus"></span> 
<span>Context menus</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/menus-and-actions/dock- 
menus"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-dock-menus"></span> 
<span>Dock menus</span> 
</span> 


</a> 
</li> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/components/menus-and-actions/edit- 
menus"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-edit-menus"></span> 
<span>Edit menus</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/menus-and-actions/ 
menus"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-menus"></span> 
<span>Menus</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/menus-and-actions/pop- 
up-buttons"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-pop-up-buttons"></span> 
<span>Pop-up buttons</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/menus-and-actions/pull- 
down-buttons"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-pull-down-buttons"></span> 


<span>Pull-down buttons</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/menus-and-actions/ 
toolbars"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-toolbars"></span> 
<span>Toolbars</span> 
</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-navigation-and-search" data-hires- 
status="pending"></span> 
<span class="dn-list-title">Navigation and search</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/navigation-and-search/ 
navigation-bars"> 
<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-navigation-bars"></span> 


<span>Navigation bars</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/navigation-and-search/ 
path-controls"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-path-controls"></span> 
<span>Path controls</span> 
</span> 
</a> 


</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/navigation-and-search/ 
search-fields"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-search-fields"></span> 
<span>Search fields</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/navigation-and-search/ 
sidebars"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-sidebars"></span> 
<span>Sidebars</span> 
</span> 


</a> 


</li> 


<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/navigation-and-search/ 
tab-bars"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-tab-bars"></span> 
<span>Tab bars</span> 
</span> 


</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/navigation-and-search/ 
token-fields"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-token-fields"></span> 
<span>Token fields</span> 
</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-presentation" data-hires- 
status="pending"></span> 


<span class="dn-list-title">Presentation</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/presentation/action- 
sheets"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-action-sheets"></span> 
<span>Action sheets</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/presentation/alerts"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-alerts"></span> 
<span>Alerts</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/presentation/page- 
controls"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-page-controls"></span> 
<span>Page controls</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/presentation/panels"> 


<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-panels"></span> 


<span>Panels</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/presentation/popovers"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-popovers"></span> 
<span>Popovers</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/presentation/scroll- 
views"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-scroll-views"></span> 
<span>Scroll views</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/presentation/sheets"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-sheets"></span> 
<span>Sheets</span> 
</span> 


</a> 


</li> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/components/presentation/windows"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-windows"></span> 
<span>Windows</span> 
</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-selection-and-input" data-hires- 
status="pending"></span> 
<span class="dn-list-title">Selection and input</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/selection-and-input/color- 
wells"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-color-wells"></span> 
<span>Color wells</span> 
</span> 


</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/selection-and-input/ 
combo-boxes"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-combo-boxes"></span> 
<span>Combo boxes</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/selection-and-input/digit- 
entry-views"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-digit-entry-views"></span> 
<span>Digit entry views</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/selection-and-input/ 
image-wells"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-image-wells"></span> 
<span>Image wells</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/selection-and-input/ 
onscreen-keyboards"> 


<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-onscreen-keyboards"></span> 


<span>Onscreen keyboards</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/selection-and-input/ 
pickers"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-pickers"></span> 
<span>Pickers</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/selection-and-input/ 
segmented-controls"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-segmented-controls"></span> 
<span>Segmented controls</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/selection-and-input/ 
sliders"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-sliders"></span> 


<span>Sliders</span> 


<li class="dn-list-item"> 


</span> 
</a> 


<a 


href="/design/human-interface-guidelines/components/selection-and-input/ 


steppers"> 


class="dn-flex"> 
<span class="dn-icon dn-icon-steppers"></span> 


<span>Steppers</span> 


<li class="dn-list-item"> 


<span 


</span> 
</a> 


<a 


href="/design/human-interface-guidelines/components/selection-and-input/text- 


fields"> 


class="dn-flex"> 
<span class="dn-icon dn-icon-text-fields"></span> 


<span>Text fields</span> 


<li class="dn-list-item"> 


<span 


</span> 
</a> 


<a 


href="/design/human-interface-guidelines/components/selection-and-input/ 


toggles"> 


class="dn-flex"> 
<span class="dn-icon dn-icon-toggles"></span> 


<span>Toggles</span> 


<span 


</span> 
</a> 


</li> 


<li class="dn-list-item"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-status" 
data-hires-status="pending"></span> 
<span class="dn-list-title">Status</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/components/status/activity-rings"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-activity-rings"></span> 
<span>Activity rings</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/status/level-indicators"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-level-indicators"></span> 
<span>Level indicators</span> 
</span> 
</a> 


</li> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/components/status/progress- 
indicators"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-progress-indicators"></span> 
<span>Progress indicators</span> 
</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-system-experiences" data-hires- 
status="pending"></span> 
<span class="dn-list-title">System experiences</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/system-experiences/ 
complications"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-complications"></span> 
<span>Complications</span> 
</span> 


</a> 
</li> 


«li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/components/system-experiences/ 
home-screen-quick-actions"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-home-screen-quick-actions"></span> 


<span>Home Screen quick actions</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/system-experiences/the- 
menu-bar"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-the-menu-bar"></span> 
<span>The menu bar</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/system-experiences/ 
notifications"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-notifications"></span> 
<span>Notifications</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/system-experiences/ 
status-bars"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-status-bars"></span> 


<span>Status bars</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/system-experiences/top- 
shelf"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-top-shelf"></span> 
<span>Top Shelf</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/system-experiences/ 
watch-faces"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-watch-faces"></span> 
<span>Watch faces</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/system-experiences/ 
widgets"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-widgets"></span> 
<span>Widgets</span> 
</span> 


</a> 


</li> 


</ul> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-inputs"></span> 
<span class="dn-list-title">Inputs</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/inputs/overview"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-overview" 
data-hires-status="pending"></span> 
<span>Overview</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/apple-pencil-and-scribble"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-apple-pencil-and-scribble" data-hires- 
status="pending"></span> 


<span>Apple Pencil and Scribble</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/digital-crown"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-digital-crown" data-hires- 
status="pending"></span> 
<span>Digital Crown</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/focus-and-selection"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-focus-and-selection" data-hires- 
status="pending"></span> 
<span>Focus and selection</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/game-controllers"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-game-controllers" data-hires- 
status="pending"></span> 
<span>Game controllers</span> 
</span> 


</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/gyro-and-accelerometer"> 
<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-gyro-and-accelerometer" data-hires- 
status="pending"></span> 


<span>Gyro and accelerometer</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/keyboards"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-keyboards" data-hires- 
status="pending"></span> 
<span>Keyboards</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/pointing-devices"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-pointing-devices" data-hires- 
status="pending"></span> 
<span>Pointing devices</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/inputs/remotes"> 


<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-remotes" 
data-hires-status="pending"></span> 


<span>Remotes</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/spatial-interactions"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-spatial-interactions" data-hires- 
status="pending"></span> 
<span>Spatial interactions</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/touch-bar"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-touch-bar" data-hires- 
status="pending"></span> 
<span>Touch Bar</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/touchscreen-gestures"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-touchscreen-gestures" data-hires- 
status="pending"></span> 


<span>Touchscreen gestures</span> 
</span> 
</a> 
</li> 


</ul> 


</li> 


<li class="dn-list-item dn-icon--active"> 
<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-technologies dn-list-item--active dn-icon-- 
active"></span> 


<span class="dn-list-title dn-list-item--active dn-icon-- 
active">Technologies</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item dn-list-item-link"> 


<a 
href="/design/human-interface-guidelines/technologies/all-technologies"> 


<span class="dn-flex"> 


<span class="dn-icon dn-icon-all-technologies" data-hires- 
status="pending"></span> 


<span>All technologies</span> 


</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-airplay" 
data-hires-status="pending"></span> 


<span class="dn-list-title">AirPlay</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/technologies/airplay/introduction"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-introduction"></span> 
<span>Introduction</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/airplay/icons"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-icons" 
data-hires-status="pending"></span> 
<span>Icons</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/airplay/editorial"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-editorial"></span> 
<span>Editorial</span> 
</span> 
</a> 


</li> 


</ul> 


</li> 


<li class="dn-list-item dn-list-item-link"> 


<a 
href="/design/human-interface-guidelines/technologies/always-on"> 


<span class="dn-flex"> 


<span class="dn-icon dn-icon-always-on" data-hires- 
status="pending"></span> 


<span>Always On</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-app-clips" 
data-hires-status="pending"></span> 
<span class="dn-list-title">App Clips</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/app-clips/introduction"> 
<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-introduction"></span> 


<span>Introduction</span> 
</span> 


</a> 


</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/app-clips/experience"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-experience"></span> 
<span>User experience</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/app-clips/app-clip-card"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-app-clip-card"></span> 
<span>App Clip card</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/app-clips/app-clip- 
codes"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-app-clip-codes"></span> 
<span>App Clip Codes</span> 
</span> 


</a> 
</li> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/technologies/app-clips/printing- 
guidelines"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-printing-guidelines"></span> 
<span>Printing guidelines</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/app-clips/legal- 
requirements"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-legal-requirements"></span> 
<span>Legal requirements</span> 
</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-apple-pay" data-hires- 
status="pending"></span> 
<span class="dn-list-title">Apple Pay</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/technologies/apple-pay/introduction"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-introduction"></span> 
<span>Introduction</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/apple-pay/offering-apple- 
pay"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-offering-apple-pay"></span> 
<span>Offering Apple Pay</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/apple-pay/checkout-and- 
payment"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-checkout-and-payment"></span> 


<span>Checkout and payment</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/apple-pay/handling- 
errors"> 
<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-handling-errors"></span> 


<span>Error handling</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/apple-pay/subscriptions- 
and-donations"> 
<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-subscriptions-and-donations"></span> 


<span>Subscriptions and donations</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/apple-pay/buttons-and- 
marks"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-buttons-and-marks"></span> 
<span>Buttons and marks</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/apple-pay/editorial- 
guidelines"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-editorial-guidelines"></span> 
<span>Editorial</span> 
</span> 


</a> 
</li> 


</ul> 


</li> 


<li class="dn-list-item dn-list-item-link dn-list-item--active"> 


<a 


href="/design/human-interface-guidelines/technologies/augmented-reality"> 


<span class="dn-flex"> 


<span class="dn-icon dn-icon-augmented-reality" data-hires- 
status="pending"></span> 


<span>Augmented reality</span> 
</span> 


</li> 


<li class="dn-list-item"> 
class="dn-flex"> 


<span class="dn-icon dn-icon-carekit" 
data-hires-status="pending"></span> 


<span class="dn-list-title">CareKit</span> 


</a> 


<span 


</span> 


<ul class="dn-list-container" 


style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/carekit/introduction"> 


class="dn-flex"> 
<span class="dn-icon dn-icon-introduction"></span> 
<span>Introduction</span> 


</a> 


<span 


</span> 


</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/carekit/data-and- 
privacy"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-data-and-privacy"></span> 
<span>Data and privacy</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/carekit/views"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-views"></span> 
<span>Views</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/carekit/user- 
experience"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-user-experience"></span> 
<span>User experience</span> 
</span> 


</a> 
</li> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/technologies/carekit/symbols-and- 
branding"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-symbols-and-branding"></span> 


<span>Symbols and branding</span> 


</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-carplay" 
data-hires-status="pending"></span> 
<span class="dn-list-title">CarPlay</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/technologies/carplay/introduction"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-introduction"></span> 
<span>Introduction</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/carplay/architecture"> 


<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-architecture"></span> 


<span>Architecture</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/carplay/interaction"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-interaction"></span> 
<span>Interaction</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/carplay/visual-design"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-visual-design"></span> 
<span>Visual design</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/carplay/icons-and- 
images"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-icons-and-images"></span> 
<span>Icons and images</span> 
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image" src="https://developer.apple.com/design/human-interface-guidelines/ 
images/supported-platforms/ios-active.svg" data-hires-status="pending"> 
</li> 
<li class="hig-platform-icon"> 
<img class="dark-mode- 
image" src="https://developer.apple.com/design/human-interface-guidelines/ 
images/supported-platforms/ipados-active.svg" data-hires-status="pending"> 
</li> 
<li class="hig-platform-icon"> 
<img class="dark-mode- 
image" src="https://developer.apple.com/design/human-interface-guidelines/ 
images/supported-platforms/macos.svg" data-hires-status="pending"> 
</li> 
<li class="hig-platform-icon"> 
<img class="dark-mode- 
image" src="https://developer.apple.com/design/human-interface-guidelines/ 
images/supported-platforms/tvos.svg" data-hires-status="pending"> 
</li> 
<li class="hig-platform-icon"> 
<img class="dark-mode- 
image" src="https://developer.apple.com/design/human-interface-guidelines/ 
images/supported-platforms/watchos.svg" data-hires-status="pending"> 
</li> 
</ul> 


</div> 
<ul 
class="Sidenav_container" style="top: 80px;"><div class="SidenavLine line 
helpers-module transition" style="transform: translateY(Opx);"></div> <li><a 
href="#" class="Sidenavitem_link helpers-module_transition 
Sidenavitem_active">Augmented reality</a> <!----></li><li><a 
href="#Resources" class="Sidenavitem_link helpers- 
module transition">Resources</a> <!----></li></ul> 
<script src="/assets/scripts/sidenav. built.js?41172203193"></script> 
</div> 
</div></h1> 


<p>Augmented reality (or AR) lets you deliver immersive, engaging experiences 
that seamlessly blend virtual objects with the real world.</p> 


<p><img src="https://developer.apple.com/design/human-interface-guidelines/ 
images/intro/technologies/technology-augmented-reality-intro 2x.png" alt="" 


title="" class="center scale dark-mode-image" width="768" height="432" data- 
hires-status="pending"></p> 


<p>Using the device's camera to present the physical world onscreen live, your 
app superimposes three-dimensional virtual objects, creating the illusion that 
these objects actually exist. Depending on the experiences your app offers, 
people can reorient the device to explore the objects from different angles, 
interact with objects using gestures and movement, and even join other people 
in multiuser AR experiences. For developer guidance, see <a 
href="https://developer.apple.com/documentation/arkit">ARKit</a>.</p> 


<p><strong>Offer AR features only on capable devices.</strong> If your app's 
primary purpose is AR, make your app available only to devices that support 
ARKit. If your app includes features that require specific AR capabilities, or if AR 
features are optional in your app, don’t show people an error ifthey try to use 
these features on a device that doesn’t support them; instead, simply avoid 
offering the feature on an unsupported device. For developer guidance, see <a 
href="https://developer.apple.com/documentation/arkit/verifying_device_support 
_and_user_permission">Verifying device support and user permission</a>.</p> 


<h3 id="creating-an-engaging-comfortable-experience">Creating an engaging, 
comfortable experience</h3> 


<p><strong>Let people use the entire display.</strong> Devote as much of the 
screen as possible to displaying the physical world and your app's virtual objects. 
Avoid cluttering the screen with controls and information that diminish the 
immersive experience.</p> 


<p><strong>Strive for convincing illusions when placing realistic 
objects.</strong> Design detailed 3D assets with lifelike textures to create 
objects that appear to inhabit the physical environment in which you place them. 
Using information from ARKit, you can scale objects properly and position them 
on detected real-world surfaces, reflect environmental lighting conditions and 
simulate camera grain, cast top-down diffuse object shadows on real-world 
surfaces, and update visuals as the camera's position changes. To help avoid 
breaking the illusion you create, make sure your app updates scenes 60 times 
per second so objects don’t appear to jump or flicker.</p> 


<p><strong>Consider how virtual objects with reflective surfaces show the 
environment.</strong> Reflections in ARKit are approximations based on the 
environment captured by the camera. To help maintain the illusion that an AR 
experience is real, prefer small or coarse reflective surfaces that downplay the 
effect of these approximations.</p> 


<p><strong>Use audio and haptics to enhance the immersive 
experience.</strong> A sound effect or bump sensation is a great way to 
confirm that a virtual object has made contact with a physical surface or other 
virtual object. Background music can also help envelop people in the virtual 
world. For guidance, see <a 
href="/design/human-interface-guidelines/patterns/playing-audio">Playing 
audio</a> and <a href="/design/human-interface-guidelines/patterns/playing- 
haptics">Playing haptics</a>.</p> 


<p><strong>Minimize text in the environment.</strong> Display only the 
information that people need for your app experience.</p> 


<p><strong>If additional information or controls are necessary, consider 
displaying them in screen space.</strong> Content in <em>screen 
space</em> appears fixed to a consistent location either in the virtual world or, 
less commonly, on the device screen. It’s typically easy for people to find and 
view content in screen space because it remains stationary while the underlying 
AR environment moves with the device.</p> 


<p><strong>Consider using indirect controls when you need to provide 
persistent controls.</strong> <em>Indirect controls</em> are not part of the 
virtual environment — instead, they are 2D controls displayed in screen space. If 
people need access to persistent controls in your app, consider placing the 
controls so that people don’t have to adjust how they're holding the device to 
reach them. Also, consider using translucency in an indirect control to help avoid 
blocking the underlying scene. For example, the Measure app uses screen space 
to display a mix of translucent and opaque controls that people use to measure 
objects in the real world.</p> 


<div class="device-iphonell-container"> 

<img src="https://developer.apple.com/design/human-interface-guidelines/ 
technologies/augmented-reality/images/arkit-measure-lines 2x.png" 
class="device-iphone11-image-full" alt="Screenshot of the Measure app showing 
a leafy plant and a line segment that extends from the base of a leaf to its tip. 
The measurement is four and a half inches." data-hires-status="pending"> 

«div class="device-iphonell-frame" alt=" 
data-hires-status="pending"></div> 
</div> 


<p><strong>Anticipate that people will use your app in a wide variety of real- 
world environments.</strong> People may open your app in a place where there 
isn't much room to move around or there aren't any large, flat surfaces. Clearly 
communicate your app's requirements and expectations to people up front to 
help them understand how their physical environment can affect their AR 
experience. You might also consider offering different sets of features for use in 
different environments. </p> 


<p><strong>Be mindful of people's comfort.</strong> Holding a device ata 
certain distance or angle for a prolonged period can be fatiguing. To help avoid 
causing fatigue, consider placing objects at a distance that reduces the need to 
move the device closer to the object; in a game, consider keeping levels short 
and intermixed with brief periods of downtime.</p> 


<p><strong>If your app encourages people to move, introduce motion 
gradually.</strong> For example, you might not want to make people dodge a 
virtual projectile as soon as they enter your AR game. Give people time to adapt 
to the AR experience in your app and then progressively encourage 
movement.</p> 


<p><strong>Be mindful of people's safety.</strong> When people are 
immersed in an AR experience, they're not necessarily aware of their physical 
surroundings, so making rapid, sweeping, or expansive motions might be 


dangerous. Consider ways of making your app safe to operate; for example, a 
game could avoid encouraging large or sudden movements.</p> 


<h3 id="using-coaching-to-get-people-started">Using coaching to get people 
started</h3> 


<p>Before people can enjoy an AR experience in your app, they need to move 
their device in ways that lets ARKit evaluate the surroundings and detect 
surfaces. In iOS 13 and later, you can use the built-in coaching view to show 
people what to do and provide feedback during the initialization process. You can 
also use the coaching view to help people reinitialize AR — a process known as 
<em>relocalization</em> — after an AR experience is interrupted by, for 
example, people switching briefly to a different app. For guidance on 
relocalization, see <a href="#handling-interruptions">Handling 
interruptions</a>; for developer guidance, see <a 
href="https://developer.apple.com/documentation/arkit/arcoachingoverlayview" 
>ARCoachingOverlayView</a>.</p> 


<div class="row padding-top-small"> 
<div class="column large-12 small-12"> 


<p><img src="https://developer.apple.com/design/human-interface-guidelines/ 
technologies/augmented-reality/images/arkit-horizontal-orientation_2x.png" 
alt="An iPhone screen showing the corner of a room viewed through the camera. 
On the screen is a translucent overlay containing the surface detection indicator. 
The indicator is a white square with rounded corners projected into 3D space. A 
small iPhone is shown scanning back and forth along the base of the square. A 
circle of dots trailing the iPhone is used to emphasize the movement." title="" 
class="center scale" width="471" height="234" data-hires- 
status="pending"></p> 


</div> 
</div> 


<p><strong>Hide unnecessary app UI while people are using a coaching 
view.</strong> By default, the coaching view appears automatically when 
initialization or relocalization starts, so you should be prepared to hide unrelated 
Ul to help people focus on the coaching view's instructions.</p> 


<p><strong>If necessary, offer a custom coaching experience.</strong> 
Although you can configure the system-provided coaching view to help people 
provide specific information — such as the detection of a horizontal or vertical 
plane — you might need additional information or want to use a different visual 
style. If you want to design a custom coaching experience, use the system- 
provided coaching view for reference.</p> 


<h3 id="helping-people-place-objects">Helping people place objects</h3> 


<p><strong>Show people when to locate a surface and place an 
object.</strong> You can use the system-provided coaching view to help people 
find a horizontal or vertical flat surface on which to place an object. After ARKit 
detects a surface, your app can display a custom visual indicator to show when 
object placement is possible. You can help people understand how the placed 


object will look in the environment by aligning your indicator with the plane of 
the detected surface.</p> 


<div class="row padding-top-small"> 
<div class="column large-12 small-12"> 


<p><img src="/design/human-interface-guidelines/technologies/augmented- 
reality/images/ARKit_Target_3.svg" alt="Diagram of a complex reticle consisting 
of a circular shape with markers indicating a center and diameter, inside right- 
angle shapes framing a square. The reticle is shown in 3D perspective with the 
longest edge on the bottom." title="" class="center" width="234" height="154" 
data-hires-status="pending"></p> 


<p class="typography-caption text-center">App-specific indicator</p> 


</div> 
</div> 


<p><strong>When people place an object, immediately integrate that object 
into the AR environment.</strong> Although surface detection quickly and 
progressively refines accuracy, it's best to avoid waiting for more accurate data 
before placing an object. Use the information available to respond instantly when 
people place an object; then, when surface detection completes, subtly refine 
the object's position if necessary. For example, if people place an object beyond 
the bounds of the detected surface, gently nudge the object back onto the 
surface. For developer guidance on refining an object's position, see <a 
href="https://developer.apple.com/documentation/arkit/artrackedraycast">ARTr 
ackedRaycast</a>.</p> 


<p><strong>Consider guiding people toward offscreen virtual 
objects.</strong> Sometimes, it can be difficult for people to locate an object 
that’s positioned offscreen. When this is the case, you can help people find such 
objects by offering visual or audible cues. For example, if an object is offscreen 
to the left, you could display an indicator along the left edge of the screen that 
guides people to point the camera in that direction.</p> 


<p><strong>Avoid trying to precisely align objects with the edges of detected 
surfaces.</strong> In AR, surface boundaries are approximations that may 
change as people's surroundings are further analyzed.</p> 


<p><strong>Incorporate plane classification information to inform object 
placement.</strong> For example, only let people place a virtual piece of 
furniture on a plane that's classified as “floor,” or require a plane to be classified 
as “table” in order to place a virtual game board.</p> 


<h3 id="designing-intuitive-delightful-object-interactions">Designing intuitive, 
delightful object interactions</h3> 


<p><strong>Let people use direct manipulation to interact with objects when 
possible.</strong> It’s more immersive and intuitive when people can interact 
with onscreen 3D objects by touching them directly, than by using indirect 
controls in screen space. However, in situations where people are moving around 
as they use your app, indirect controls can work better.</p> 


<div class="row padding-top-small no-padding-bottom"> 
<div class="column large-6 small-12"> 


<p><img src="https://developer.apple.com/design/human-interface-guidelines/ 
technologies/augmented-reality/images/ARKit User Interaction Right.svg" 
alt="Diagram showing a cube and a hand with the index finger touching the 
cube. There is a curved line intersecting the finger and cube to indicate the 
movement of the finger." title="" class="center dark-mode-image" width="152" 
height="210" data-hires-status="pending"></p> 


<p class="typography-caption text-center">Direct manipulation</p> 


</div> 
<div class="column large-6 small-12"> 


<p><img src="https://developer.apple.com/design/human-interface-guidelines/ 
technologies/augmented-reality/images/ARKit_User_Interaction_Wrong.svg" 
alt="Diagram showing a cube. Below the cube are two buttons, each with a 
circular arrow pointing in the opposite direction." title="" class="center dark- 
mode-image" width="152" height="210" data-hires-status="pending"></p> 


<p class="typography-caption text-center">Indirect controls</p> 


</div> 
</div> 


<p><strong>Let people directly interact with virtual objects using standard, 
familiar gestures.</strong> For example, consider supporting a single-finger 
drag gesture for moving objects, and a two-finger rotation gesture for spinning 
objects. For guidance, see <a 
href="/design/human-interface-guidelines/inputs/touchscreen- 
gestures">Touchscreen gestures</a>.</p> 


<p><strong>In general, keep interactions simple.</strong> Touch gestures are 
inherently two-dimensional, but an AR experience involves the three dimensions 
of the real world. Consider the following approaches to simplifying user 
interactions with virtual objects.</p> 


<div class="row no-padding-top no-padding-bottom"> 
<div class="column large-6 small-12"> 


<p><img src="https://developer.apple.com/design/human-interface-guidelines/ 
technologies/augmented-reality/images/ARKit_10.svg" alt="Diagram showing a 
sphere. The base of the sphere is on a grid. Two lines that are parallel to the grid 
and to each other pass through the center of the sphere. There is an arrow at the 
tip of each line indicating movement direction." title="" class="center dark- 
mode-image" width="234" height="150" data-hires-status="pending"></p> 


<p class="typography-caption text-center">Limit movement to the two- 
dimensional surface on which the object rests.</p> 


</div> 
<div class="column large-6 small-12"> 


<p><img src="https://developer.apple.com/design/human-interface-guidelines/ 
technologies/augmented-reality/images/ARKit_09.svg" alt="Diagram showing a 
sphere. A dotted line runs vertically through the center of the sphere. An arrow 
wraps around the outside of the sphere and the vertical line from left to right 
indicating movement of the sphere around that line." title="" class="center dark- 
mode-image" width="234" height="150" data-hires-status="pending"></p> 


<p class="typography-caption text-center">Limit object rotation to a single 
axis.</p> 


</div> 
</div> 


<p><strong>Respond to gestures within reasonable proximity of interactive 
virtual objects.</strong> It can be difficult for people to be precise when aiming 
to touch specific points on objects that are small, thin, or placed at a distance. 
When your app detects a gesture near an interactive object, it's usually best to 
assume that people want to affect that object.</p> 


<p><strong>Support user-initiated object scaling when it makes sense in your 
app.</strong> For example, if your app lets people explore an imaginary 
environment, it probably makes sense to support object scaling because your 
app doesn’t need to represent the real world. On the other hand, if your app 
helps shoppers decide on furniture to buy, letting people scale a chair object 
doesn’t help them visualize how the chair will look in a room.</p> 


<div class="note"> 


<p><strong>TIP</strong> Regardless of the purpose of your app, don’t use 
scaling as a way to adjust the distance of an object. If you enlarge a distant 
object in an effort to make it appear closer, the result is a larger object that still 
looks far away.</p> 


</div> 


<p><strong>Be wary of potentially conflicting gestures.</strong> A two-finger 
pinch gesture, for example, is similar to a two-finger rotation gesture. If you 
implement two similar gestures like this, be sure to test your app and make sure 
they're interpreted properly.</p> 


<p><strong>Strive for virtual object movement that’s consistent with the 
physics of your app’s AR environment.</strong> People don’t necessarily expect 
an object to move smoothly over a rough or uneven surface, but they do expect 
objects to remain visible during movement. Aim to keep moving objects attached 
to real-world surfaces and avoid causing objects to jump or vanish and reappear 
as people resize, rotate, or move them.</p> 


<p><strong>Explore even more engaging methods of interaction.</strong> 
Gestures aren't the only way for people to interact with virtual objects in AR. 
Your app can use other factors, like motion and proximity, to bring content to 
life. A game character, for example, could turn its head to look at a person as 
they walk toward it.</p> 


<h3 id="designing-a-great-multiuser-experience">Designing a great multiuser 
experience</h3> 


<p>When multiple people share your app's AR experience, each participant 
maps the environment independently and ARKit automatically merges the maps. 
For developer guidance, see <a 
href="https://developer.apple.com/documentation/arkit/arworldtrackingconfigura 
tion/3152987-iscollaborationenabled">isCollaborationEnabled</a>.</p> 


<p><strong>Consider enabling people occlusion.</strong> If your app supports 
placing virtual objects behind people who appear in the device's camera feed, 
enhance the illusion of reality by letting the people occlude the objects. For 
developer guidance, see <a 
href="https://developer.apple.com/documentation/arkit/occluding virtual conten 
t with people">Occluding virtual content with people</a>.</p> 


<p><strong>When possible, let new participants enter a multiuser AR 
experience.</strong> Unless your app requires all participants to join before the 
experience begins, consider using implicit map merging to let new people quickly 
join an ongoing AR experience. For developer guidance, see <a 
href="https://developer.apple.com/documentation/arkit/arworldtrackingconfigura 
tion/3152987-iscollaborationenabled">isCollaborationEnabled</a>.</p> 


<h3 id="reacting-to-real-world-objects">Reacting to real-world objects</h3> 


<p>You can enhance an AR experience by using known images and objects in 
the real-world environment to trigger the appearance of virtual content. For 
example, an app that recognizes theater posters for a sci-fi film could cause 
virtual space ships to emerge from the posters and fly around the environment. 
Another example is an app for an art museum that presents a virtual tour guide 
when it recognizes a sculpture. To enable experiences like these, your app 
provides a set of 2D reference images or 3D reference objects, and ARKit 
indicates when and where it detects any of these items in the current 
environment. For developer guidance, see <a 
href="https://developer.apple.com/documentation/arkit/recognizing images in a 
n ar experience">Recognizing images in an AR experience</a>.</p> 


<p><strong>When a detected image first disappears, consider delaying the 
removal of virtual objects that are attached to it.</strong> ARKit doesn’t track 
changes to the position or orientation of each detected image. To help prevent 
virtual objects from flickering, consider waiting up to one second before fading 
them out or removing them.</p> 


<p><strong>Limit the number of reference images in use at one 
time.</strong> Image detection performance works best when ARKit looks for 
100 or fewer distinct images in the real-world environment. If you need more 
than 100 reference images, you can change the set of active reference images 
based on context. For example, a museum guide app could ask permission to 
use location services to determine the part of the museum a person is in, and 
then look only for images displayed in that area.</p> 


<p><strong>Limit the number of reference images requiring an accurate 
position.</strong> Updating the position of a reference image requires more 
resources. Use a tracked image when the image may move in the environment 


or when an attached animation or virtual object is small compared to the size of 
the image.</p> 


<h3 id="communicating-with-people">Communicating with people</h3> 


<p><strong>If you must display instructional text, use approachable 
terminology.</strong> AR is an advanced concept that may be intimidating to 
some people. To help make it approachable, avoid using technical terms like 
ARKit, world detection, and tracking. Instead, use friendly, conversational terms 
that most people will understand.</p> 


<table> 
<thead> 
<tr> 
<th>Do</th> 
<th>Don't</th> 
</tr> 
</thead> 
<tbody> 
<tr> 
<td>Unable to find a surface. Try moving to the side or repositioning your 
phone. </td> 
<td>Unable to find a plane. Adjust tracking.</td> 
</tr> 
<tr> 
<td>Tap a location to place the <em>[name of object to be 
placed]</em>.</td> 
<td>Tap a plane to anchor an object.</td> 
</tr> 
<tr> 
<td>Try turning on more lights and moving around.</td> 
<td>Insufficient features.</td> 
</tr> 
<tr> 
<td>Try moving your phone more slowly.</td> 
<td>Excessive motion detected.</td> 
</tr> 
</tbody> 
</table> 


<p><strong>In a three-dimensional context, prefer 3D hints.</strong> For 
example, placing a 3D rotation indicator around an object is more intuitive than 
displaying text-based instructions in a 2D overlay. Avoid displaying textual 
overlay hints in a 3D context unless people aren’t responding to contextual 
hints.</p> 


<div class="row padding-top-small no-padding-bottom"> 
<div class="column large-6 small-12"> 


<p><img src="https://developer.apple.com/design/human-interface-guidelines/ 
technologies/augmented-reality/images/ARKit_11.svg" alt="Diagram of a cube. 
The base of the cube is indicated with a grid, and the active side of the cube is 
outlined in blue. Arrows follow a continuous circle around the cube to the right, 


indicating the direction of motion." title="" class="center dark-mode-image" 
width="234" height="200" data-hires-status="pending"></p> 


<p class="typography-caption text-center">Prefer a 3D hint in a 3D 
context.</p> 


</div> 
<div class="column large-6 small-12"> 


<p><img src="https://developer.apple.com/design/human-interface-guidelines/ 
technologies/augmented-reality/images/ARKit_06.svg" alt="Diagram of a cube. 
The base of the cube is indicated with a grid, and underneath the cube is the text 
&quot;Rotate&quot; shown in white inside a black oval." title="" class="center 
dark-mode-image" width="234" height="200" 
data-hires-status="pending"></p> 


<p class="typography-caption text-center">If necessary, use a 2D hint in a 3D 
context.</p> 


</div> 
</div> 


<p><strong>Make important text readable.</strong> Use screen space to 
display text used for critical labels, annotations, and instructions. If you need to 
display text in 3D space, make sure the text faces people and that you use the 
same type size regardless of the distance between the text and the labeled 
object.</p> 


<p><strong>If necessary, provide a way to get more information.</strong> 
Design a visual indicator that fits with your app experience to show people that 
they can tap for more information.</p> 


<div class="row padding-top-small"> 
<div class="column large-12 small-12"> 


<p><img src="https://developer.apple.com/design/human-interface-guidelines/ 
technologies/augmented-reality/images/arkit-labels_2x.png" alt="An iPhone 
screen in landscape showing the corner of a room viewed through the camera. In 
the room are two AR objects: a desk and a chair. Each object has a label in white 
text enclosed in a black oval. The oval is attached to the object by a vertical line. 
The label in each object ends with two spaces and a greater-than sign to indicate 
the label can be tapped for more information." title="" class="center scale" 
width="471" height="234" data-hires-status="pending"></p> 


</div> 
</div> 


<div class="row padding-top-small"> 
<div class="column large-12 small-12"> 


<p><img src="https://developer.apple.com/design/human-interface-guidelines/ 
technologies/augmented-reality/images/arkit-popover_2x.png" alt="An iPhone 

screen in landscape showing a full screen view with the detailed information for 
a chair. On the left side of the screen is an image of the chair, in the middle is a 


vertical separator line, and on the right is the model number, price, and size of 
the chair." title="" class="center scale" width="471" height="234" data-hires- 
status="pending"></p> 


</div> 
</div> 


<h3 id="handling-interruptions">Handling interruptions</h3> 


<p>ARKit can't track device position and orientation during an interruption, such 
as when people briefly switch to another app or accept a phone call. After an 
interruption ends, previously placed virtual objects are likely to appear in the 
wrong real-world positions. When you enable relocalization, ARKit attempts to 
restore those virtual objects to their original real-world positions using new 
information. For developer guidance, see <a 
href="https://developer.apple.com/documentation/arkit/managing_session_lifecy 
cle_and_tracking_quality">Managing session lifecycle and tracking 
quality</a>.</p> 


<p><strong>Consider using the system-provided coaching view to help people 
relocalize.</strong> During relocalization, ARKit attempts to reconcile its 
previous state with new observations of the current environment. To enable 
these observations, you can use the coaching view to help people return the 
device to its previous position and orientation.</p> 


<div class="row padding-top-small"> 
<div class="column large-12 small-12"> 


<p><img src="https://developer.apple.com/design/human-interface-guidelines/ 
technologies/augmented-reality/images/arkit-vertical-orientation_2x.png" 
alt="An iPhone screen showing the corner of a room viewed through the camera. 
On the screen is a translucent overlay containing the surface detection indicator. 
The indicator is a white square with rounded corners projected into 3D space. A 
small iPhone is shown scanning back and forth along the base of the square. A 
circle of dots trailing the iPhone is used to emphasize the movement." title=" 
class="center scale" width="234" height="471" data-hires- 
status="pending"></p> 


</div> 
</div> 


<p><strong>Consider hiding previously placed virtual objects during 
relocalization.</strong> To avoid flickering or other unpleasant visual effects 
during relocalization, it can be best to hide virtual objects and redisplay them in 
their new positions.</p> 


<p><strong>Minimize interruptions if your app supports both AR and non-AR 
experiences.</strong> One way to avoid interruptions is by embedding a non-AR 
experience within an AR experience so that people can handle the task without 
exiting and re-entering AR. For example, if your app helps people decide on a 
piece of furniture to purchase by placing the item in a room, you might let them 
change the upholstery without leaving the AR experience.</p> 


<p><strong>Allow people to cancel relocalization.</strong> If people don’t 
position and orient their device near where it was before an interruption, 
relocalization continues indefinitely without success. If coaching people to 
resume their session isn’t successful, consider providing a reset button or other 
way to restart the AR experience.</p> 


<p><strong>Indicate when the front-facing camera is unable to track a face for 
more than about half a second.</strong> Use a visual indicator to indicate that 
the camera can no longer track the person’s face. If you need to provide text 
instructions in this situation, keep them to a minimum.</p> 


<h3 id="suggesting-ways-to-resolve-problems">Suggesting ways to resolve 
problems</h3> 


<p><strong>Let people reset the experience if it doesn’t meet their 
expectations.</strong> Don't force people to wait for conditions to improve or 
struggle with object placement. Give them a way to start over again and see if 
they have better results.</p> 


<div class="row no-padding-top no-padding-bottom"> 
<div class="column large-6 small-12"> 


<p><img src="/design/human-interface-guidelines/technologies/augmented- 
reality/images/ARKit_01.svg" alt="Diagram showing a corner of a brightly lit 
office. A desk, chair, filing cabinet, and part of a window are visible. A green 
check mark below the diagram indicates that this is sufficient lighting." title="" 
class="center" width="368" height="250" data-hires-status="pending"></p> 


<p class="typography-caption text-center">Sufficient lighting</p> 


</div> 
<div class="column large-6 small-12"> 


<p><img src="/design/human-interface-guidelines/technologies/augmented- 
reality/images/ARKit_02.svg" alt="Diagram showing the same office as the 
previous image with a black background. The corner of the room, desk, chair, 
filing cabinet, and window are all drawn as white line art. A red X below the 
diagram indicates that this is insufficient lighting." title="" class="center" 
width="368" height="250" data-hires-status="pending"></p> 


<p class="typography-caption text-center">Insufficient lighting</p> 


</div> 
</div> 


<p><strong>Suggest possible fixes if problems occur.</strong> Analysis of the 
real-world environment and surface detection can fail or take too long for a 
variety of reasons — insufficient light, an overly reflective surface, a surface 
without enough detail, or too much camera motion. If your app is notified of 
these problems, use straightforward, friendly language to offer suggestions for 
resolving them.</p> 


<table> 
<thead> 


<tr> 
<th>Problem</th> 
<th>Possible suggestion</th> 
</tr> 
</thead> 
<tbody> 
<tr> 
<td>Insufficient features detected.</td> 
<td>Try turning on more lights and moving around.</td> 
</tr> 
<tr> 
<td>Excessive motion detected.</td> 
<td>Try moving your phone slower.</td> 
</tr> 
<tr> 
<td>Surface detection takes too long.</td> 
<td>Try moving around, turning on more lights, and making sure your phone is 
pointed at a sufficiently textured surface.</td> 
</tr> 
</tbody> 
</table> 


<h3 id="ar-icon">AR icon</h3> 


<p>Apps can display an AR icon in controls that launch ARKit-based 
experiences. You can download this icon in <a href="/design/resources/#ios- 
apps">Resources</a>.</p> 


<div class="row no-padding-top no-padding-bottom"> 
<div class="column large-4 small-12"> 


<p><img src="https://developer.apple.com/design/human-interface-guidelines/ 
technologies/augmented-reality/images/ARKit_Glyph.svg" alt="The AR glyph." 
title="" class="center dark-mode-image" width="234" height="105" data-hires- 
status="pending"></p> 


</div> 
<div class="column large-8 small-12"> 


<p><img src="/design/human-interface-guidelines/technologies/augmented- 
reality/images/ARKit_Glyph_Button.svg" alt="A button containing the AR glyph 
and the text View in AR." title="" class="center" width="412" height="105" 
data-hires-status="pending"></p> 


</div> 
</div> 


<p><strong>Use the AR glyph as intended.</strong> The glyph should be used 
strictly for initiating an ARKit-based experience. Never alter the glyph (other than 
adjusting its size and color), use it for other purposes, or use it in conjunction 
with AR experiences not created using ARKit.</p> 


<p><strong>Maintain minimum clear space.</strong> The minimum amount of 
clear space required around an AR glyph is 10% of the glyph's height. Don’t let 
other elements infringe on this space or occlude the glyph in any way.</p> 


<p><img src="https://developer.apple.com/design/human-interface-guidelines/ 
technologies/augmented-reality/images/ARKit_Glyph_Clear.svg" alt="Diagram 
showing the AR glyph centered within a dotted square to indicate leaving space 
around the glyph." title="" class="center dark-mode-image" width="234" 
height="105" data-hires-status="pending"></p> 


<h3 id="ar-badges">AR badges</h3> 


<p>Apps that include collections of products or other objects can use badging to 
identify specific items that can be viewed in AR using ARKit. For example, a 
department store app might use a badge to mark furniture that people can 
preview in their home before making a purchase.</p> 


<p><img src="/design/human-interface-guidelines/technologies/augmented- 
reality/images/arkit-badging.svg" alt="Partial diagram of an iPhone view with the 
title &quot; Home Decor&quot;. In the view are four gray squares each containing 
a picture of an item of furniture: a standing desk lamp, an articulating desk lamp, 
a filing cabinet, and a small chest of drawers. In the upper left corner of each 
square is the AR badge with the glyph and the text AR." title="" class="center" 
width="368" height="396" data-hires-status="pending"></p> 


<p><strong>Use the AR badges as intended and don’t alter them.</strong> 
You can download AR badges, available in collapsed and expanded form, in <a 
href="/design/resources/#ios-apps">Resources</a>. Use these images 
exclusively to identify products or other objects that can be viewed in AR using 
ARKit. Never alter the badges, change their color, use them for other purposes, 
or use them in conjunction with AR experiences not created with ARKit.</p> 


<div class="row no-padding-top no-padding-bottom"> 
<div class="column large-6 small-12"> 


<p><img src="/design/human-interface-guidelines/technologies/augmented- 
reality/images/ARKit Badge IconAndText.svg" alt="The AR badge with both the 
glyph and the text AR." title="" class="center" width="234" height="152" data- 
hires-status="pending"></p> 


<p class="typography-caption text-center">AR badge</p> 


</div> 
<div class="column large-6 small-12"> 


<p><img src="/design/human-interface-guidelines/technologies/augmented- 
reality/images/ARKit Badge Icon.svg" alt="The glyph-only ARKit badge." title="" 
class="center" width="234" height="152" data-hires-status="pending"></p> 
<p class="typography-caption text-center">Glyph-only AR badge</p> 


</div> 
</div> 


<p><strong>Prefer the AR badge to the glyph-only badge.</strong> In general, 
use the glyph-only badge for constrained spaces that can't accommodate the AR 
badge. Both badges work well at their default size.</p> 


<p><strong>Use badging only when your app contains a mixture of objects that 
can be viewed in AR and objects that cannot.</strong> If all objects in your app 
can be viewed in AR, then badging is redundant.</p> 


<p><strong>Keep badge placement consistent and clear.</strong> A badge 
looks best when displayed in one corner of an object's photo. Always place it in 
the same corner and make sure it's large enough to be seen clearly (but not so 
large that it occludes important detail in the photo).</p> 


<p><strong>Maintain minimum clear space.</strong> The minimum amount of 
clear space required around an AR badge is 10% of the badge's height. Other 
elements shouldn't infringe on this space and occlude the badge in any 
way.</p> 


<div class="row no-padding-top"> 
<div class="column large-6 small-12"> 


<p><img src="/design/human-interface-guidelines/technologies/augmented- 
reality/images/ARKit Badge IconAndText Clear.svg" alt="Image of the badge 
with the AR glyph and text AR with a dotted square around the outside to 
indicate leaving space around the badge." title="" class="center" width="234" 
height="152" data-hires-status="pending"></p> 


</div> 
<div class="column large-6 small-12"> 


<p><img src="/design/human-interface-guidelines/technologies/augmented- 
reality/images/ARKit Badge Icon Clear.svg" alt="Image of the glyph-only AR 
badge with a dotted square around the outside to indicate leaving space around 
the badge." title="" class="center" width="234" height="152" data-hires- 
status="pending"></p> 


</div> 
</div> 


<!-- Resources --> 


<div class="hig-resources" data-hires="true"> 
<h2 id="Resources" data- 
sidenav="">Resources</h2> 


<h4>Related</h4> 
<ul class="no-bullet no-margin- 
left"> 


<li><a 
href="/design/human-interface-guidelines/patterns/playing-haptics">Playing 
haptics</a></li> 


<li><a 
href="/design/human-interface-guidelines/inputs/touchscreen- 
gestures">Touchscreen gestures</a></li> 


<li><a 
href="https://developer.apple.com/design/resources/#ios-apps">Apple Design 
Resources</a></li> 


</ul> 


<h4>Developer documentation</h4> 
<ul class="no-bullet no-margin- 
left"> 


<li><a 
href="https://developer.apple.com/documentation/arkit">ARKit</a></li> 


</ul> 


<h4>Videos</h4> 
<ul class="no-bullet no-margin-left 
video-grid"> 


<li> 
<a id="wwdc2022- 
10131" href="/videos/play/wwdc2022/10131/"> 
<img 
class="video-grid-img" 
src="https://devimages-cdn.apple.com/wwdc-services/images/124/6628/6628 wi 
de 250x141 2x.jpg" data-hires-status="pending"> 
<p 
class="video-grid-title">Qualities of great AR experiences</p> 
<p 
class="video-grid-detail">WWDC22</p> 
</a> 
</li> 


<li> 
<a id="wwdc2021- 
10073" href="/videos/play/wwdc2021/10073/"> 
<img 
class="video-grid-img" 
src="https://devimages-cdn.apple.com/wwdc-services/images/119/4965/4965 wi 
de 250x141 2x.jpg" data-hires-status="pending"> 
<p 
class="video-grid-title">Explore ARKit 5</p> 
<p 
class="video-grid-detail">WWDC21</p> 
</a> 
</li> 


</ul> 


</div> 
</div> 
</div> 
</div> 
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class="footer-directory-column-section-anchor footer-directory-column-section- 
anchor-open"> <span class="footer-directory-column-section-anchor- 
label">Open Menu</span> </a> 
<a href="#" class="footer-directory-column-section-anchor 
footer-directory-column-section-anchor-close"> <span class="footer-directory- 
column-section-anchor-label">Close Menu</span> </a> 
<ul class="footer-directory-column-section-list"> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/accelerator/">App 
Accelerators</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/app-store/app-store- 
awards/">App Store Awards</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/design/awards/">Apple 
Design Awards</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="/learn/experts/#academies">Apple Developer Academies</a></li> 
<li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/entrepreneur- 
camp/">Entrepreneur Camp</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/tech-talks/">Tech 
Talks</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/wwdc/">WWDC</a></li> 
</ul> 
</div> 
</div> 
<!--googleon: all--> 
</nav> 


<section class="footer-mini" vocab="http://schema.org/" 
typeof="Organization"> 
<div class="footer-mini-news"> 
<div class="copy"> 
To view the latest developer news, visit <a 
href="/news/">News and Updates</a>. 
</div> 
<div class="content"> 
<div class="color-scheme-toggle" role="radiogroup" 
tabindex="0" aria-label="Select a color scheme preference"> 


<label data-color-scheme-option="light"> 


<input type="radio" value="light" 
autocomplete="off" 
onchange="window.setPreferredColorScheme(event.target.value)"> 


<div class="text">Light</div> 
</label> 
<label data-color-scheme-option="dark"> 


<input type="radio" value="dark" 
autocomplete="off" 
onchange="window.setPreferredColorScheme(event.target.value)"> 


<div class="text">Dark</div> 
</label> 
<label data-color-scheme-option="auto"> 


<input type="radio" value="auto" 
autocomplete="off" 
onchange="window.setPreferredColorScheme(event.target.value)"> 


<div class="text">Auto</div> 
</label> 


</div> 
<script async="" src="/assets/scripts/color-scheme- 
toggle.js"></script> 
</div> 
</div> 
<link rel="stylesheet" href="/assets/styles/language-dropdown.css? 
41172203193"> 
<div class="language-dropdown dropdown-container hidden"> 
<select class="dropdown" aria-label="Language 
Dropdown"></select> 
<span class="dropdown-icon icon icon-chevrondown" aria- 
hidden="true"></span> 
</div> 


<script async="" src="/assets/scripts/lib/jquery/jquery.language- 
dropdown.js?41172203193"></script> 
<div class="footer-mini-legal"> 
<div class="footer-mini-legal-copyright">Copyright © 2022 <a 
href="https://www.apple.com">Apple Inc.</a> All rights reserved.</div> 
<div class="footer-mini-legal-links"> 
<a class="footer-mini-legal-link" 
href="https://www.apple.com/legal/internet-services/terms/site.html">Terms of 
Use</a> 
<a class="footer-mini-legal-link" 
href="https://www.apple.com/legal/privacy/en-ww/">Privacy Policy</a> 
<a class="footer-mini-legal-link" 
href="/support/terms/">Agreements and Guidelines</a> 
</div> 
</div> 
</section> 
</div> 
</footer> 


</body></html><html xmins="https://www.w3.org/1999/xhtml" xml:lang="en" 
lang="en"><head> 
<meta charset="utf-8"> 
<meta name="Author" content="Apple Inc."> 
<meta name="viewport" content="width=device-width, initial-scale=1, 
viewport-fit=cover"> 
<link rel="shortcut icon" href="/favicon.ico"> 
<link rel="icon" href="/favicon.ico"> 
<link rel="mask-icon" href="/apple-logo.svg" color="#333333"> 


<link rel="stylesheet" href="/assets/styles/global.dist.css?41172203193" 
type="text/css"> 


<link rel="stylesheet" href="/assets/styles/localization.css?41172203193" 
type="text/css"> 


<script src="/assets/scripts/lib/jquery/jquery-3.6.0.min.js?41172203193"></ 
script> 

<script src="/assets/scripts/settings.js?41172203193"></script> 

<script src="/assets/scripts/language-locales.js?41172203193"></script> 
<script src="/assets/scripts/DeveloperBreadcrumbs.js?41172203193"></script> 


<script async="" src="/assets/scripts/lib/jquery/jquery.retinate.js? 
41172203193"></script> 

<script async="" src="/assets/scripts/global.js?41172203193"></script> 
<script async="" src="/assets/scripts/global-logout.js?41172203193"></script> 


<link rel="stylesheet" href="https://www.apple.com/wss/fonts? 
family=SF+Pro&amp;v=2" type="text/css"> 
<link rel="stylesheet" href="https://www.apple.com/wss/fonts? 
family=SF+Pro+lcons&amp;v=1" type="text/css"> 


<link rel="stylesheet" href="https://www.apple.com/wss/fonts? 
family=SF+Mono&amp;v=2" type="text/css"> 

<link rel="stylesheet" href="https://www.apple.com/wss/fonts? 
family=Apple+lcons&amp;v=1" type="text/css"> 


<title>Platforms - Platforms - Human Interface Guidelines - Design - Apple 
Developer</title> 

<meta name="omni_page" content="Platforms - Platforms - Human 
Interface Guidelines - Design - (English)"> 

<meta name="Description" content="Platforms"> 

<meta name="php check" content="4"> 


<meta name="search_thumbnail" content="/design/human- 
interface-guidelines/images/thumbnails/platforms/platforms-thumbnail_2x.png"> 


<link rel="alternate" 
href="https://developer.apple.com/design/human-interface-guidelines/ 
platforms/overview/" hreflang="en"> 

<link rel="canonical" 
href="https://developer.apple.com/design/human-interface-guidelines/ 
platforms/overview/"> 


<script 
src="/design/human-interface-guidelines/scripts/application.js? 
58172205193&quot;&gt;"></script> 


<script src="/assets/scripts/lib/jquery/jquery.bxslider.min.js? 
41172203193&quot;&gt;"></script> 


<script src="/design/human-interface-guidelines/scripts/hig-nav.js? 
58172205193&quot;&gt;"></script> 


<script 
src="/design/human-interface-guidelines/scripts/darkModelmages.js? 
59202215202&quot;&gt;"></script> 


<link rel="stylesheet" type="text/css" 
href="/design/human-interface-guidelines/styles/application.css? 
14172206193 &quot;&gt;"> 


<link rel="stylesheet" type="text/css" href="/design/human-interface- 
guidelines/styles/human-interface-guidelines.css?01002216211&quot;&gt;"> 
<style type="text/css">.helpers- 
module transition 4 
transition-duration: 160ms; 
transition-timing-function: cubic-bezier(0.25, 0.46, 0.45, 0.94); 
> «/style» «style type="text/css">.SidenavLine line I 
position: absolute; 
top: 0; 
left: -1px; 
width: 1px; 
height: 25px; 
background: black; 
will-change: transform; 


transition-property: transform; 
} 
</style><style type="text/css">.Sidenavitem_children { 
margin: 0; 
opacity: 0.6; 


.Sidenavltem link 4 

opacity: 0.6; 

padding: 0.2em 0; 
border-radius: 4px; 

color: #111; 

font-size: 14px; 

font-weight: 600; 

will-change: opacity; 
transition-property: opacity; 


„Sidenavltem children .Sidenavltem link 4 
font-weight: normal; 


„Sidenavltem active, 

„Sidenavltem link:hover 4 
opacity: 1; 
text-decoration: none; 


</style><style type="text/css"> 
.Sidenav_container 1 
position: sticky; 
position: -webkit-sticky; 
top: 52px; 
left: 100px; 
border-left: 1px solid #e3e3e3; 
padding: 0 18px; 
margin: 0 0 lem; 
} 
.Sidenav_container * { 
display: block; 


</style></head> 
<body data-hignav-item-name="" data-hignav-is-beta="false" id="platforms- 
overview" class="dmf " data-color-scheme="light"> 


<link rel="stylesheet" href="/assets/styles/globalnav.css?41172203193" 
type="text/css"> 


<link rel="stylesheet" href="/assets/styles/suggest-lang.css?41172203193" 
type="text/css"> 
<div id="suggest-lang" class="ribbon hide"> 
<div class="ribbon-content-wrapper"> 
<div class="ribbon-content row"> 
<div class="column large-12 large-centered"> 

<a id="suggest-closer" class="icon icon-after icon- 
reset"></a> 

<p><a href="#" id="suggest-link" class="ribbon-link 
more">View in English</a></p> 


</div> 
</div> 
</div> 
</div> 
<script src="/assets/scripts/suggest-lang.js?41172203193"></script> 
«aside id="ac-gn-segmentbar" class="ac-gn-segmentbar" lang="en-US" 
dir="ltr"> 
</aside> 
<input type="checkbox" id="ac-gn-menustate" class="ac-gn-menustate"> 
<nav id="ac-globalnav" class="js touch no-windows" role="navigation" aria- 
label="Global" data-hires="false" data-analytics-region="global nav" lang="en- 
US" dir="Itr" data-www-domain="www.apple.com" data-store-locale="us" data- 
store-root-path="/us" data-store-api="/[storefront]/shop/bag/status" data- 
search-locale="en_US" 
data-search-suggestions-api="/search-services/suggestions/" data-search- 
defaultlinks-api="/search-services/suggestions/defaultlinks/" data-search- 
suggestions-enabled="false"> 
<div class="ac-gn-content"> 
<ul class="ac-gn-header"> 
<li class="ac-gn-item ac-gn-menuicon"> 
<label class="ac-gn-menuicon-label" for="ac-gn- 
menustate" aria-hidden="true"> 
<span class="ac-gn-menuicon-bread ac-gn- 
menuicon-bread-top"> 
<span class="ac-gn-menuicon-bread- 
crust ac-gn-menuicon-bread-crust-top"></span> 
</span> 
<span class="ac-gn-menuicon-bread ac-gn- 
menuicon-bread-bottom"> 
<span class="ac-gn-menuicon-bread- 
crust ac-gn-menuicon-bread-crust-bottom"></span> 
</span> 
</label> 
<a href="#ac-gn-menustate" role="button" class="ac- 
gn-menuanchor ac-gn-menuanchor-open" id="ac-gn-menuanchor-open"> 
<span class="ac-gn-menuanchor-label">Global 
Nav Open Menu</span> 
</a> 
<a href="#" role="button" class="ac-gn-menuanchor 
ac-gn-menuanchor-close" id="ac-gn-menuanchor-close"> 
<span class="ac-gn-menuanchor-label">Global 
Nav Close Menu</span> 
</a> 
</li> 
<li class="ac-gn-item ac-gn-apple"> 
<a class="ac-gn-link ac-gn-link-apple-developer" 
href="/" data-analytics-title="appledeveloper home" id="ac-gn-firstfocus- 
small"> 
<span class="ac-gn-link-text">Apple 
Developer</span> 
</a> 
</li> 
</ul> 
<div class="ac-gn-search-placeholder-container" role="search"> 


<div class="ac-gn-search ac-gn-search-small"> 
<a id="ac-gn-link-search-small" class="ac-gn-link" 
href="/search/" data-analytics-title="search" data-analytics-click="search" data- 
analytics-intrapage-link="" aria-label="Search" role="button" aria- 
haspopup="true"> 
<div class="ac-gn-search-placeholder-bar"> 
<div class="ac-gn-search-placeholder- 
input" > 
<div class="ac-gn-search- 
placeholder-input-text" aria-hidden="true"> 
<div class="ac-gn-link- 
search ac-gn-search-placeholder-input-icon"></div> 
<span class="ac-gn-search- 
placeholder">Search</span> 
</div> 
</div> 
<div class="ac-gn-searchview-close ac- 
gn-searchview-close-small ac-gn-search-placeholder-searchview-close"> 
<span class="ac-gn-searchview- 
close-cancel" aria-hidden="true">Cancel</span> 
</div> 
</div> 
</a> 
</div> 
</div> 
<ul class="ac-gn-list"> 
<li class="ac-gn-item ac-gn-apple"> 
<a class="ac-gn-link ac-gn-link-apple-developer" 
href="/" data-analytics-title="appledeveloper home" id="ac-gn-firstfocus"> 
<span class="ac-gn-link-text">Apple 
Developer</span> 
</a> 
</li> 
<li class="ac-gn-item ac-gn-item-menu ac-gn-news"> 
<a class="ac-gn-link ac-gn-link-news" href="/news/" 
data-analytics-title="news"> 
<span class="ac-gn-link-text">News</span> 
</a> 
</li> 
<li class="ac-gn-item ac-gn-item-menu ac-gn-discover"> 
<a class="ac-gn-link ac-gn-link-discover" 
href="/discover/" data-analytics-title="discover"> 
<span 
class="ac-gn-link-text">Discover</span> 
</a> 
</li> 
<li class="ac-gn-item ac-gn-item-menu ac-gn-design"> 
<a class="ac-gn-link ac-gn-link-design" href="/design/" 
data-analytics-title="design"> 
<span class="ac-gn-link-text">Design</span> 
</a> 
</li> 
<li class="ac-gn-item ac-gn-item-menu ac-gn-develop"> 


<a class="ac-gn-link ac-gn-link-develop" 
href="/develop/" data-analytics-title="develop"> 
<span class="ac-gn-link-text">Develop</span> 
</a> 
</li> 
<li class="ac-gn-item ac-gn-item-menu ac-gn-distribute"> 
<a class="ac-gn-link ac-gn-link-distribute" 
href="/distribute/" data-analytics-title="distribute"> 
<span 
class="ac-gn-link-text">Distribute</span> 
</a> 
</li> 
<li class="ac-gn-item ac-gn-item-menu ac-gn-dsupport"> 
<a class="ac-gn-link ac-gn-link-dsupport" 
href="/support/" data-analytics-title="dsupport"> 
<span class="ac-gn-link-text" >Support</span> 
</a> 
</li> 
<li class="ac-gn-item ac-gn-item-menu ac-gn-account"> 
<a class="ac-gn-link ac-gn-link-account" 
href="/account/" data-analytics-title="account"> 
<span class="ac-gn-link-text">Account</span> 
</a> 
</li> 
<li class="ac-gn-item ac-gn-item-menu ac-gn-search" 
role="search"> 
<a id="ac-gn-link-search" class="ac-gn-link ac-gn-link- 
search" href="/search/" data-analytics-title="search" data-analytics- 
click="search" data-analytics-intrapage-link="" aria-label="Search" 
role="button" aria-haspopup="true"></a> 
</li> 
</ul> 
<aside id="ac-gn-searchview" class="ac-gn-searchview" 
role="search" data-analytics-region="search"> 
<div class="ac-gn-searchview-content"> 
<div class="ac-gn-searchview-bar"> 
<div class="ac-gn-searchview-bar-wrapper"> 
<form id="ac-gn-searchform" class="ac- 
gn-searchform" action="/search/" method="get"> 
<div class="ac-gn-searchform- 
wrapper"> 
<input id="ac-gn- 
searchform-input" class="ac-gn-searchform-input" type="text" name="q" aria- 
label="Search" placeholder="Search" autocorrect="off" autocapitalize="off" 
autocomplete="off" spellcheck="false" role="combobox" aria- 
autocomplete="list" aria-expanded="true" aria-owns="quicklinks suggestions"> 
<button id="ac-gn- 
searchform-submit" class="ac-gn-searchform-submit" type="submit" 
disabled="" aria-label="Submit Search"></button> 
<button id="ac-gn- 
searchform-reset" class="ac-gn-searchform-reset" type="reset" disabled="" 
aria-label="Clear Search"> 
<span 
class="ac-gn-searchform-reset-background"></span> 


</button> 
</div> 
<input type="hidden" id="search-hidden- 
input" value="HIG" name="group"></form> 
<button id="ac-gn-searchview-close- 
small" class="ac-gn-searchview-close ac-gn-searchview-close-small" aria- 
label="Cancel Search"> 
<span class="ac-gn- 
searchview-close-cancel" aria-hidden="true"> 
Cancel 
</span> 
</button> 
</div> 
</div> 
<aside id="ac-gn-searchresults" class="ac-gn- 
searchresults" data-string-quicklinks="Quick Links" data-string- 
suggestions="Suggested Searches" data-string-noresults=""> 
<section class="ac-gn-searchresults-section ac-gn-searchresults- 
section-defaultlinks"> 
<div class="ac-gn-searchresults-section-wrapper"> 
<div class="search-group- 
checkbox"><input id="group-input" type="checkbox" name="group-filter" 
checked="" value="HIG">Only search within “<span id="group-search- 
label">Human Interface Guidelines</span>"</div> 
<h3 class="ac-gn-searchresults-header ac-gn-searchresults- 
animated">Quick Links</h3> 
<ul class="ac-gn-searchresults-list" id="defaultlinks" 
role="listbox"> 
<li class="ac-gn-searchresults-item ac-gn-searchresults- 
animated"><a href="https://developer.apple.com/ios/" id="search-group-link-0" 
class="ac-gn-searchresults-link ac-gn-searchresults-link-defaultlinks">iOS 
16</a></li><li class="ac-gn-searchresults-item ac-gn-searchresults- 
animated"><a href="https://developer.apple.com/news/" id="search-group-link- 
1" class="ac-gn-searchresults-link ac-gn-searchresults-link-defaultlinks">Latest 
News</a></li><li class="ac-gn-searchresults-item ac-gn-searchresults- 
animated"><a 
href="https://developer.apple.com/documentation/storekit/appstore/ 
environment/3963900-xcode/" id="search-group-link-2" class="ac-gn- 
searchresults-link ac-gn-searchresults-link-defaultlinks">xcode</a></li><li 
class="ac-gn-searchresults-item ac-gn-searchresults-animated"><a 
href="https://developer.apple.com/xcode/whats-new/" id="search-group-link-3" 
class="ac-gn-searchresults-link ac-gn-searchresults-link-defaultlinks">What’s 
included in Xcode</a></li><li class="ac-gn-searchresults-item ac-gn- 
searchresults-animated"><a 
href="https://developer.apple.com/videos/play/wwdc2022/110345/" id="search- 
group-link-4" class="ac-gn-searchresults-link ac-gn-searchresults-link- 
defaultlinks">What’s new in Endpoint Security</a></li></ul> 
<span role="status" class="ac-gn-searchresults-count" aria- 
live="polite">5 Quick Links</span> 
</div> 
</section> 
</aside> 
</div> 


<button id="ac-gn-searchview-close" class="ac-gn- 

searchview-close" aria-label="Cancel Search"> 
<span class="ac-gn-searchview-close- 
wrapper"> 
<span class="ac-gn-searchview-close- 
left"></span> 
<span class="ac-gn-searchview-close- 
right"></span> 
</span> 
</button> 
</aside> 

</div> 
</nav> 
<div class="ac-gn-blur"></div> 
<div id="ac-gn-curtain" class="ac-gn-curtain"></div> 
<div id="ac-gn-placeholder" class="ac-nav-placeholder"></div> 
<script src="/assets/scripts/ac-globalnav.built.js?41172203193"></script><div 
id="ac-gn-viewport-emitter"> </div> 
<link rel="stylesheet" href="/assets/styles/search.css?41172203193"> 
<script src="/assets/scripts/search.js?41172203193"></script> 


<!-- metrics --> 
<script> 
/* RSID: */ 
var s account="awdappledeveloper" 
</script> 
<script src="/assets/metrics/scripts/analytics.js?10202020"></script> 
<script> 
s.pageName= AC && AC.Tracking && AC.Tracking.pageName(); 
s.channel="www.en.developer" 
s.channel="www.hig.developer"; 


perreo DO NOT ALTER ANYTHING BELOW THIS LINE | ero / 
var ss code=s.t();if(s code)document.write(s code) 

</script> 

<!-- /metrics --> 


<link rel="stylesheet" property="stylesheet" 
href="/assets/styles/localnav.css" type="text/css"> 
<input type="checkbox" id="localnav-menustate" class="localnav-menustate"> 
<div id="localnav-sticky-placeholder" class="css-sticky 
localnav-sticking"></div><nav id="localnav" class="localnav localnav-scrim 
css-sticky localnav-sticking" data-sticky="" role="navigation"> 
<div class="localnav-wrapper"> 
<div class="localnav-background"></div> 
<div class="localnav-content"> 
<h2 class="localnav-title"> 
<a class="ac-In-title-logo" href="/design/" data-analytics- 
title="product index">Human Interface Guidelines</a> 
</h2> 


<div class="localnav-menu"> 


<a href="#localnav-menustate" class="localnav-menucta-anchor 
localnav-menucta-anchor-open" id="localnav-menustate-open"> 
<span class="localnav-menucta-anchor-label">Open Menu</span> 
</a> 
<a href="#" class="localnav-menucta-anchor localnav-menucta- 
anchor-close" id="localnav-menustate-close"> 
<span class="localnav-menucta-anchor-label">Close Menu</span> 
</a> 
<div class="localnav-menu-tray"> 
<div class="dn-container"> 
<nav id="dn-mobile" class="dn localnav- 
menu-items" role="navigation" aria-label="Local Navigation" data-hires="true"> 


<ul class="dn-list-container" 
style="max-height: 658px; transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item dn-icon--active" > 
<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-platforms dn-list-item--active dn-icon-- 
active"></span> 


<span class="dn-list-title dn-list-item--active dn-icon-- 
active">Platforms</span> 
</span> 


<ul class="dn-list-container dn-- 


expanded" style="position: relative; visibility: unset; max-height: 220px; 
transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item dn-list-item--active"> 


<a 
href="/design/human-interface-guidelines/platforms/overview"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-overview" 
data-hires-status="pending"></span> 
<span>Overview</span> 
</span> 
</a> 


</li> 


«li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/platforms/designing-for-ios"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-designing-for-ios" data-hires- 
status="pending"></span> 
<span>Designing for ¡OS</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/platforms/designing-for-ipados"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-designing-for-ipados" data-hires- 
status="pending"></span> 
<span>Designing for iPadOS</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/platforms/designing-for-macos"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-designing-for-macos" data-hires- 
status="pending"></span> 
<span>Designing for macOS</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/platforms/designing-for-tvos"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-designing-for-tvos" data-hires- 
status="pending"></span> 


<span>Designing for tvOS</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/platforms/designing-for-watchos"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-designing-for-watchos" data-hires- 
status="pending"></span> 


<span>Designing for watchOS</span> 


</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-foundations"></span> 
<span class="dn-list-title">Foundations</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/foundations/overview"> 
<span 
class="dn-flex"> 
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</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/presentation/alerts"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-alerts"></span> 
<span>Alerts</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/presentation/page- 
controls"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-page-controls"></span> 
<span>Page controls</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/presentation/panels"> 


<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-panels"></span> 


<span>Panels</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/presentation/popovers"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-popovers"></span> 
<span>Popovers</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/presentation/scroll- 
views"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-scroll-views"></span> 
<span>Scroll views</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/presentation/sheets"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-sheets"></span> 
<span>Sheets</span> 
</span> 


</a> 


</li> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/components/presentation/windows"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-windows"></span> 
<span>Windows</span> 
</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-selection-and-input" data-hires- 
status="pending"></span> 
<span class="dn-list-title">Selection and input</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/selection-and-input/color- 
wells"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-color-wells"></span> 
<span>Color wells</span> 
</span> 


</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/selection-and-input/ 
combo-boxes"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-combo-boxes"></span> 
<span>Combo boxes</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/selection-and-input/digit- 
entry-views"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-digit-entry-views"></span> 
<span>Digit entry views</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/selection-and-input/ 
image-wells"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-image-wells"></span> 
<span>Image wells</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/selection-and-input/ 
onscreen-keyboards"> 


<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-onscreen-keyboards"></span> 


<span>Onscreen keyboards</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/selection-and-input/ 
pickers"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-pickers"></span> 
<span>Pickers</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/selection-and-input/ 
segmented-controls"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-segmented-controls"></span> 
<span>Segmented controls</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/selection-and-input/ 
sliders"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-sliders"></span> 


<span>Sliders</span> 


<li class="dn-list-item"> 


</span> 
</a> 


<a 


href="/design/human-interface-guidelines/components/selection-and-input/ 


steppers"> 


class="dn-flex"> 
<span class="dn-icon dn-icon-steppers"></span> 


<span>Steppers</span> 


<li class="dn-list-item"> 


<span 


</span> 
</a> 


<a 


href="/design/human-interface-guidelines/components/selection-and-input/text- 


fields"> 


class="dn-flex"> 
<span class="dn-icon dn-icon-text-fields"></span> 


<span>Text fields</span> 


<li class="dn-list-item"> 


<span 


</span> 
</a> 


<a 


href="/design/human-interface-guidelines/components/selection-and-input/ 


toggles"> 


class="dn-flex"> 
<span class="dn-icon dn-icon-toggles"></span> 


<span>Toggles</span> 


<span 


</span> 
</a> 


</li> 


<li class="dn-list-item"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-status" 
data-hires-status="pending"></span> 
<span class="dn-list-title">Status</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/components/status/activity-rings"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-activity-rings"></span> 
<span>Activity rings</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/status/level-indicators"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-level-indicators"></span> 
<span>Level indicators</span> 
</span> 
</a> 


</li> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/components/status/progress- 
indicators"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-progress-indicators"></span> 
<span>Progress indicators</span> 
</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-system-experiences" data-hires- 
status="pending"></span> 
<span class="dn-list-title">System experiences</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/system-experiences/ 
complications"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-complications"></span> 
<span>Complications</span> 
</span> 


</a> 
</li> 


«li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/components/system-experiences/ 
home-screen-quick-actions"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-home-screen-quick-actions"></span> 


<span>Home Screen quick actions</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/system-experiences/the- 
menu-bar"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-the-menu-bar"></span> 
<span>The menu bar</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/system-experiences/ 
notifications"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-notifications"></span> 
<span>Notifications</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/system-experiences/ 
status-bars"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-status-bars"></span> 


<span>Status bars</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/system-experiences/top- 
shelf"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-top-shelf"></span> 
<span>Top Shelf</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/system-experiences/ 
watch-faces"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-watch-faces"></span> 
<span>Watch faces</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/system-experiences/ 
widgets"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-widgets"></span> 
<span>Widgets</span> 
</span> 


</a> 


</li> 


</ul> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-inputs"></span> 
<span class="dn-list-title">Inputs</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/inputs/overview"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-overview" 
data-hires-status="pending"></span> 
<span>Overview</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/apple-pencil-and-scribble"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-apple-pencil-and-scribble" data-hires- 
status="pending"></span> 


<span>Apple Pencil and Scribble</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/digital-crown"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-digital-crown" data-hires- 
status="pending"></span> 
<span>Digital Crown</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/focus-and-selection"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-focus-and-selection" data-hires- 
status="pending"></span> 
<span>Focus and selection</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/game-controllers"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-game-controllers" data-hires- 
status="pending"></span> 
<span>Game controllers</span> 
</span> 


</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/gyro-and-accelerometer"> 
<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-gyro-and-accelerometer" data-hires- 
status="pending"></span> 


<span>Gyro and accelerometer</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/keyboards"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-keyboards" data-hires- 
status="pending"></span> 
<span>Keyboards</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/pointing-devices"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-pointing-devices" data-hires- 
status="pending"></span> 
<span>Pointing devices</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/inputs/remotes"> 


<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-remotes" 
data-hires-status="pending"></span> 


<span>Remotes</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/spatial-interactions"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-spatial-interactions" data-hires- 
status="pending"></span> 
<span>Spatial interactions</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/touch-bar"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-touch-bar" data-hires- 
status="pending"></span> 
<span>Touch Bar</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/touchscreen-gestures"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-touchscreen-gestures" data-hires- 
status="pending"></span> 


<span>Touchscreen gestures</span> 


</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-technologies"></span> 
<span class="dn-list-title">Technologies</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item dn-list-item-link"> 


<a 
href="/design/human-interface-guidelines/technologies/all-technologies"> 


<span class="dn-flex"> 


<span class="dn-icon dn-icon-all-technologies" data-hires- 
status="pending"></span> 


<span>All technologies</span> 


</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-airplay" 
data-hires-status="pending"></span> 


<span class="dn-list-title">AirPlay</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/technologies/airplay/introduction"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-introduction"></span> 
<span>Introduction</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/airplay/icons"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-icons" 
data-hires-status="pending"></span> 
<span>Icons</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/airplay/editorial"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-editorial"></span> 
<span>Editorial</span> 
</span> 
</a> 


</li> 


</ul> 


</li> 


<li class="dn-list-item dn-list-item-link"> 


href="/design/human-interface-guidelines/technologies/always-on"> 
<span class="dn-flex"> 


<span class="dn-icon dn-icon-always-on" data-hires- 
status="pending"></span> 


<span>Always On</span> 
</span> 


</li> 


<li class="dn-list-item"> 
class="dn-flex"> 


<span class="dn-icon dn-icon-app-clips" 
data-hires-status="pending"></span> 


<span class="dn-list-title">App Clips</span> 


<a 


</a> 


<span 


</span> 


<ul class="dn-list-container" 


style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/app-clips/introduction"> 


class="dn-flex"> 
<span class="dn-icon dn-icon-introduction"></span> 
<span>Introduction</span> 


</a> 


<span 


</span> 


</li> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/technologies/app-clips/experience"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-experience"></span> 
<span>User experience</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/app-clips/app-clip-card"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-app-clip-card"></span> 
<span>App Clip card</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/app-clips/app-clip- 
codes"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-app-clip-codes"></span> 
<span>App Clip Codes</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/app-clips/printing- 
guidelines"> 


<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-printing-guidelines"></span> 


<span>Printing guidelines</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/app-clips/legal- 
requirements"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-legal-requirements"></span> 
<span>Legal requirements</span> 
</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-apple-pay" data-hires- 
status="pending"></span> 
<span class="dn-list-title">Apple Pay</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/apple-pay/introduction"> 
<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-introduction"></span> 


<span>Introduction</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/apple-pay/offering-apple- 
pay"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-offering-apple-pay"></span> 
<span>Offering Apple Pay</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/apple-pay/checkout-and- 
payment"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-checkout-and-payment"></span> 


<span>Checkout and payment</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/apple-pay/handling- 
errors"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-handling-errors"></span> 
<span>Error handling</span> 
</span> 


</a> 


</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/apple-pay/subscriptions- 
and-donations"> 
<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-subscriptions-and-donations"></span> 


<span>Subscriptions and donations</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/apple-pay/buttons-and- 
marks"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-buttons-and-marks"></span> 
<span>Buttons and marks</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/apple-pay/editorial- 
guidelines"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-editorial-guidelines"></span> 
<span>Editorial</span> 
</span> 


</a> 
</li> 


</ul> 


</li> 


<li class="dn-list-item dn-list-item-link"> 


<a 


href="/design/human-interface-guidelines/technologies/augmented-reality"> 


<span class="dn-flex"> 


<span class="dn-icon dn-icon-augmented-reality" data-hires- 
status="pending"></span> 


<span>Augmented reality</span> 
</span> 


</li> 


<li class="dn-list-item"> 
class="dn-flex"> 


<span class="dn-icon dn-icon-carekit" 
data-hires-status="pending"></span> 


<span class="dn-list-title">CareKit</span> 


</a> 


<span 


</span> 


<ul class="dn-list-container" 


style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/carekit/introduction"> 


class="dn-flex"> 
<span class="dn-icon dn-icon-introduction"></span> 
<span>Introduction</span> 


</a> 
</li> 


<span 


</span> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/carekit/data-and- 
privacy"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-data-and-privacy"></span> 
<span>Data and privacy</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/carekit/views"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-views"></span> 
<span>Views</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/carekit/user- 
experience"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-user-experience"></span> 
<span>User experience</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/carekit/symbols-and- 
branding"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-symbols-and-branding"></span> 


<span>Symbols and branding</span> 


</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-carplay" 
data-hires-status="pending"></span> 
<span class="dn-list-title">CarPlay</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/technologies/carplay/introduction"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-introduction"></span> 
<span>Introduction</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/carplay/architecture"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-architecture"></span> 


<span>Architecture</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
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<span>Designing order tracking</span> 


</span> 
</a> 
</li> 

</ul> 

</li> 
</ul> 

</li> 
</ul> 


</nav> 
</div> 
<ul class="localnav-menu-items"> 

<li class="localnav-menu-item"> 

<a href="/design/" class="localnav-menu-link">Overview</a> 
</li> 
<li class="localnav-menu-item"> 

<a href="/design/whats-new/" class="localnav-menu- 

link">What's New</a> 

</li> 


<li class="localnav-menu-item"> 
<a 
href="/design/human-interface-guidelines/guidelines/overview" class="localnav- 
menu-link">Guidelines</a> 
</li> 
<li class="localnav-menu-item"> 
<a href="/design/awards/" class="localnav-menu-link">Design 
Awards</a> 
</li> 
<li class="localnav-menu-item"> 
<a href="/videos/design/" class="localnav-menu- 
link">Videos</a> 
</li> 
<li class="localnav-menu-item"> 
<a href="/design/resources/" class="localnav-menu- 
link">Resources</a> 
</li> 
</ul> 
</div> 
<div class="localnav-actions"> 
«div class="localnav-action localnav-action-menucta" aria- 
hidden="true"> 
<label for="localnav-menustate" class="localnav-menucta"> 
<span class="localnav-menucta-chevron"></span> 
</label> 
</div> 
</div> 


</div> 
</div> 
</div> 
</nav> 
<label id="localnav-curtain" for="localnav-menustate"></label> 
<script src="/assets/scripts/ac-localnav.built.js"></script><div id="localnav- 
viewport-emitter" data-viewport-emitter-dispatch="" data-viewport-emitter- 
state="{ &quot;viewport&quot;:&quot;small&quot;, &quot;orientation&quot;:&quo 
t;portrait&quot;,&quot;retina&quot;:true}"></div> 
<script type="text/javascript" src="/assets/scripts/localnav.js"></script> 


«main id="main" class="main main-hig" role="main"> 


<!-- HIG content --> 
<section class="section section-hig-container" id="section-hig- 


container"> 
<div id="grid-spacer"></div> 
<div class="section-content"> 
<div class="row row-hig-container" id="row-hig- 
container"> 


<!-- Side navigation --> 
<div class="column dn-container small-hide" 
style="align-self: flex-start;"> 
<nav id="dn" class="dn" 
role="navigation" aria-label="Local Navigation" data-hires="true"> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item dn-icon--active"> 
<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-platforms dn-list-item--active dn-icon-- 
active"></span> 


<span class="dn-list-title dn-list-item--active dn-icon-- 
active">Platforms</span> 
</span> 
<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item dn-list-item--active"> 


<a 
href="/design/human-interface-guidelines/platforms/overview"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-overview" 
data-hires-status="pending"></span> 
<span>Overview</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/platforms/designing-for-ios"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-designing-for-ios" data-hires- 
status="pending"></span> 
<span>Designing for ¡OS</span> 
</span> 


</a> 
</li> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/platforms/designing-for-ipados"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-designing-for-ipados" data-hires- 
status="pending"></span> 
<span>Designing for iPadOS</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/platforms/designing-for-macos"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-designing-for-macos" data-hires- 
status="pending"></span> 
<span>Designing for macOS</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/platforms/designing-for-tvos"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-designing-for-tvos" data-hires- 
status="pending"></span> 
<span>Designing for tvOS</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/platforms/designing-for-watchos"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-designing-for-watchos" data-hires- 
status="pending"></span> 


<span>Designing for watchOS</span> 


</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-foundations"></span> 
<span class="dn-list-title">Foundations</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/foundations/overview"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-overview" 
data-hires-status="pending"></span> 
<span>Overview</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/foundations/accessibility"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-accessibility" data-hires- 
status="pending"></span> 
<span>Accessibility</span> 


</li> 


<li class="dn-list-item"> 


</a> 


<a 


href="/design/human-interface-guidelines/foundations/app-icons"> 


class="dn-flex"> 


<span class="dn-icon dn-icon-app-icons" data-hires- 
status="pending"></span> 
<span>App icons</span> 


</li> 


<li class="dn-list-item"> 


</a> 


<a 


href="/design/human-interface-guidelines/foundations/branding"> 


class="dn-flex"> 


<span class="dn-icon dn-icon-branding" 
data-hires-status="pending"></span> 


<span>Branding</span> 


</li> 


<li class="dn-list-item"> 
href="/design/human-interface-guidelines/foundations/color"> 
class="dn-flex"> 


<span class="dn-icon dn-icon-color" 
data-hires-status="pending"></span> 


<span>Color</span> 


</a> 


<a 


</a> 


</span> 


<span 


</span> 


<span 


</span> 


<span 


</span> 


</li> 


<li class="dn-list-item"> 


<a 


href="/design/human-interface-guidelines/foundations/dark-mode"> 


class="dn-flex"> 


<span class="dn-icon dn-icon-dark-mode" data-hires- 
status="pending"></span> 


<span>Dark Mode</span> 


</li> 


<li class="dn-list-item"> 
href="/design/human-interface-guidelines/foundations/icons"> 
class="dn-flex"> 


<span class="dn-icon dn-icon-icons" 
data-hires-status="pending"></span> 


<span>Icons</span> 


</li> 


<li class="dn-list-item"> 
href="/design/human-interface-guidelines/foundations/images"> 
class="dn-flex"> 


<span class="dn-icon dn-icon-images" 
data-hires-status="pending"></span> 
<span>Images</span> 


</li> 


«li class="dn-list-item"> 


</a> 


<a 


</a> 


<a 


</a> 


<span 


</span> 


<span 


</span> 


<span 


</span> 


<a 
href="/design/human-interface-guidelines/foundations/inclusion"> 


class="dn-flex"> 


<span class="dn-icon dn-icon-inclusion" 
data-hires-status="pending"></span> 


<span>Inclusion</span> 


</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/foundations/layout"> 
class="dn-flex"> 
<span class="dn-icon dn-icon-layout" 
data-hires-status="pending"></span> 
<span>Layout</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/foundations/materials"> 
class="dn-flex"> 


<span class="dn-icon dn-icon-materials" data-hires- 
status="pending"></span> 


<span>Materials</span> 


</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/foundations/motion"> 


class="dn-flex"> 


<span 


</span> 


<span 


</span> 


<span 


</span> 


<span 


<span class="dn-icon dn-icon-motion" 
data-hires-status="pending"></span> 


<span>Motion</span> 


</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/foundations/right-to-left"> 
class="dn-flex"> 


<span class="dn-icon dn-icon-right-to-left" data-hires- 
status="pending"></span> 


<span>Right to left</span> 


</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/foundations/sf-symbols"> 
class="dn-flex"> 


<span class="dn-icon dn-icon-sf-symbols" data-hires- 
status="pending"></span> 


<span>SF Symbols</span> 


</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/foundations/typography"> 
class="dn-flex"> 


<span class="dn-icon dn-icon-typography" data-hires- 
status="pending"></span> 


<span>Typography</span> 


</a> 


</span> 


<span 


</span> 


<span 


</span> 


<span 


</span> 


</li> 


</ul> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-patterns"></span> 
<span class="dn-list-title">Patterns</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/patterns/overview"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-overview" 
data-hires-status="pending"></span> 
<span>Overview</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/accessing-private-data"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-accessing-private-data" data-hires- 
status="pending"></span> 


<span>Accessing private data</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/patterns/drag-and-drop"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-drag-and-drop" data-hires- 
status="pending"></span> 
<span>Drag and drop</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/entering-data"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-entering-data" data-hires- 
status="pending"></span> 
<span>Entering data</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/feedback"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-feedback" 
data-hires-status="pending"></span> 
<span>Feedback</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/patterns/file-management"> 


<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-file-management" data-hires- 
status="pending"></span> 


<span>File management</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/going-full-screen"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-going-full-screen" data-hires- 
status="pending"></span> 
<span>Going full screen</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/launching"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-launching" data-hires- 
status="pending"></span> 
<span>Launching</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/live-viewing-apps"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-live-viewing-apps" data-hires- 
status="pending"></span> 


<span>Live-viewing apps</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/loading"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-loading" 
data-hires-status="pending"></span> 
<span>Loading</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/managing-accounts"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-managing-accounts" data-hires- 
status="pending"></span> 
<span>Managing accounts</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/managing-notifications"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-managing-notifications" data-hires- 
status="pending"></span> 


<span>Managing notifications</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/patterns/modality"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-modality" 
data-hires-status="pending"></span> 
<span>Modality</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/multitasking"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-multitasking" data-hires- 
status="pending"></span> 
<span>Multitasking</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/offering-help"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-offering-help" data-hires- 
status="pending"></span> 
<span>Offering help</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/patterns/onboarding"> 


<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-onboarding" data-hires- 
status="pending"></span> 


<span>Onboarding</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/playing-audio"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-playing-audio" data-hires- 
status="pending"></span> 
<span>Playing audio</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/playing-haptics"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-playing-haptics" data-hires- 
status="pending"></span> 
<span>Playing haptics</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/playing-video"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-playing-video" data-hires- 
status="pending"></span> 


<span>Playing video</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/printing"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-printing" 
data-hires-status="pending"></span> 
<span>Printing</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/ratings-and-reviews"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-ratings-and-reviews" data-hires- 
status="pending"></span> 
<span>Ratings and reviews</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/patterns/searching"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-searching" data-hires- 
status="pending"></span> 
<span>Searching</span> 
</span> 
</a> 


</li> 


<li class="dn-list-item"> 
href="/design/human-interface-guidelines/patterns/settings"> 
class="dn-flex"> 


<span class="dn-icon dn-icon-settings" 
data-hires-status="pending"></span> 
<span>Settings</span> 


</li> 


<li class="dn-list-item"> 


<a 


</a> 


<a 


href="/design/human-interface-guidelines/patterns/undo-and-redo"> 


class="dn-flex"> 


<span class="dn-icon dn-icon-undo-and-redo" data-hires- 
status="pending"></span> 


<span>Undo and redo</span> 


</li> 


<li class="dn-list-item"> 
href="/design/human-interface-guidelines/patterns/workouts"> 
class="dn-flex"> 
<span class="dn-icon dn-icon-workouts" 
data-hires-status="pending"></span> 
<span>Workouts</span> 


</li> 


</ul> 


</a> 


<a 


</a> 


</li> 


<span 


</span> 


<span 


</span> 


<span 


</span> 


<li class="dn-list-item"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-components"></span> 
<span class="dn-list-title">Components</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item dn-list-item-link"> 


<a 
href="/design/human-interface-guidelines/components/all-components"> 


<span class="dn-flex"> 


<span class="dn-icon dn-icon-all-components" data-hires- 
status="pending"></span> 


<span>All components</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-content" 
data-hires-status="pending"></span> 
<span class="dn-list-title">Content</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/content/image-views"> 


<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-image-views"></span> 


<span>Image views</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/content/text-views"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-text-views"></span> 
<span>Text views</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/content/web-views"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-web-views"></span> 
<span>Web views</span> 
</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-layout-and-organization" data-hires- 
status="pending"></span> 


<span class="dn-list-title">Layout and organization</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/layout-and-organization/ 
boxes"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-boxes"></span> 
<span>Boxes</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/layout-and-organization/ 
collections"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-collections"></span> 
<span>Collections</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/layout-and-organization/ 
column-views"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-column-views"></span> 
<span>Column views</span> 
</span> 


</a> 


</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/layout-and-organization/ 
disclosure-controls"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-disclosure-controls"></span> 
<span>Disclosure controls</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/layout-and-organization/ 
labels"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-labels"></span> 
<span>Labels</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/layout-and-organization/ 
lists-and-tables"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-lists-and-tables"></span> 
<span>Lists and tables</span> 
</span> 


</a> 
</li> 


«li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/components/layout-and-organization/ 
lockups"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-lockups"></span> 
<span>Lockups</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/layout-and-organization/ 
outline-views"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-outline-views"></span> 
<span>Outline views</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/layout-and-organization/ 
split-views"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-split-views"></span> 
<span>Split views</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/layout-and-organization/ 
tab-views"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-tab-views"></span> 


<span>Tab views</span> 
</span> 
</a> 
</li> 


</ul> 


</li> 


<li class="dn-list-item"> 
<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-menus-and-actions" data-hires- 
status="pending"></span> 


<span class="dn-list-title">Menus and actions</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/menus-and-actions/ 
activity-views"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-activity-views"></span> 
<span>Activity views</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/menus-and-actions/ 
buttons"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-buttons"></span> 


<span>Buttons</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/menus-and-actions/ 
context-menus"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-context-menus"></span> 
<span>Context menus</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/menus-and-actions/dock- 
menus"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-dock-menus"></span> 
<span>Dock menus</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/menus-and-actions/edit- 
menus"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-edit-menus"></span> 
<span>Edit menus</span> 
</span> 


</a> 


</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/menus-and-actions/ 
menus"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-menus"></span> 
<span>Menus</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/menus-and-actions/pop- 
up-buttons"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-pop-up-buttons"></span> 
<span>Pop-up buttons</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/menus-and-actions/pull- 
down-buttons"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-pull-down-buttons"></span> 
<span>Pull-down buttons</span> 
</span> 


</a> 
</li> 


«li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/components/menus-and-actions/ 
toolbars"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-toolbars"></span> 
<span>Toolbars</span> 
</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-navigation-and-search" data-hires- 
status="pending"></span> 
<span class="dn-list-title">Navigation and search</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/navigation-and-search/ 
navigation-bars"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-navigation-bars"></span> 
<span>Navigation bars</span> 
</span> 


</a> 
</li> 


«li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/components/navigation-and-search/ 
path-controls"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-path-controls"></span> 
<span>Path controls</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/navigation-and-search/ 
search-fields"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-search-fields"></span> 
<span>Search fields</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/navigation-and-search/ 
sidebars"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-sidebars"></span> 
<span>Sidebars</span> 
</span> 


</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/navigation-and-search/ 
tab-bars"> 
<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-tab-bars"></span> 


<span>Tab bars</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/navigation-and-search/ 
token-fields"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-token-fields"></span> 
<span>Token fields</span> 
</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-presentation" data-hires- 
status="pending"></span> 
<span class="dn-list-title">Presentation</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/presentation/action- 
sheets"> 
<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-action-sheets"></span> 


<span>Action sheets</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/presentation/alerts"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-alerts"></span> 
<span>Alerts</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/presentation/page- 
controls"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-page-controls"></span> 
<span>Page controls</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/presentation/panels"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-panels"></span> 
<span>Panels</span> 
</span> 
</a> 


</li> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/components/presentation/popovers"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-popovers"></span> 
<span>Popovers</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/presentation/scroll- 
views"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-scroll-views"></span> 
<span>Scroll views</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/presentation/sheets"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-sheets"></span> 
<span>Sheets</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/presentation/windows"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-windows"></span> 


<span>Windows</span> 
</span> 
</a> 
</li> 


</ul> 


</li> 


<li class="dn-list-item"> 
<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-selection-and-input" data-hires- 
status="pending"></span> 


<span class="dn-list-title">Selection and input</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/selection-and-input/color- 
wells"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-color-wells"></span> 
<span>Color wells</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/selection-and-input/ 
combo-boxes"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-combo-boxes"></span> 


<span>Combo boxes</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/selection-and-input/digit- 
entry-views"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-digit-entry-views"></span> 
<span>Digit entry views</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/selection-and-input/ 
image-wells"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-image-wells"></span> 
<span>Image wells</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/selection-and-input/ 
onscreen-keyboards"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-onscreen-keyboards"></span> 
<span>Onscreen keyboards</span> 
</span> 


</a> 


</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/selection-and-input/ 
pickers"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-pickers"></span> 
<span>Pickers</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/selection-and-input/ 
segmented-controls"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-segmented-controls"></span> 
<span>Segmented controls</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/selection-and-input/ 
sliders"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-sliders"></span> 
<span>Sliders</span> 
</span> 


</a> 
</li> 


«li class="dn-list-item"> 


<a 


href="/design/human-interface-guidelines/components/selection-and-input/ 


steppers"> 


class="dn-flex"> 
<span class="dn-icon dn-icon-steppers"></span> 


<span>Steppers</span> 


<li class="dn-list-item"> 


<span 


</span> 
</a> 


<a 


href="/design/human-interface-guidelines/components/selection-and-input/text- 


fields" > 


class="dn-flex"> 
<span class="dn-icon dn-icon-text-fields"></span> 


<span>Text fields</span> 


<li class="dn-list-item"> 


<span 


</span> 
</a> 


<a 


href="/design/human-interface-guidelines/components/selection-and-input/ 


toggles"> 


class="dn-flex"> 
<span class="dn-icon dn-icon-toggles"></span> 


<span>Toggles</span> 


<span 


</span> 
</a> 


</li> 


<li class="dn-list-item"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-status" 
data-hires-status="pending"></span> 
<span class="dn-list-title">Status</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/components/status/activity-rings"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-activity-rings"></span> 
<span>Activity rings</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/status/level-indicators"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-level-indicators"></span> 
<span>Level indicators</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/status/progress- 
indicators"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-progress-indicators"></span> 


<span>Progress indicators</span> 
</span> 
</a> 
</li> 


</ul> 


</li> 


<li class="dn-list-item"> 
<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-system-experiences" data-hires- 
status="pending"></span> 


<span class="dn-list-title">System experiences</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/system-experiences/ 
complications"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-complications"></span> 
<span>Complications</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/system-experiences/ 
home-screen-quick-actions"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-home-screen-quick-actions"></span> 


<span>Home Screen quick actions</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/system-experiences/the- 
menu-bar"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-the-menu-bar"></span> 
<span>The menu bar</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/system-experiences/ 
notifications"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-notifications"></span> 
<span>Notifications</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/system-experiences/ 
status-bars"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-status-bars"></span> 
<span>Status bars</span> 
</span> 


</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/components/system-experiences/top- 
shelf"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-top-shelf"></span> 
<span>Top Shelf</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/system-experiences/ 
watch-faces"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-watch-faces"></span> 
<span>Watch faces</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/components/system-experiences/ 
widgets"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-widgets"></span> 
<span>Widgets</span> 
</span> 


</a> 
</li> 


</ul> 


</li> 


</ul> 


</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-inputs"></span> 
<span class="dn-list-title">Inputs</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/inputs/overview"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-overview" 
data-hires-status="pending"></span> 
<span>Overview</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/apple-pencil-and-scribble"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-apple-pencil-and-scribble" data-hires- 
status="pending"></span> 


<span>Apple Pencil and Scribble</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/inputs/digital-crown"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-digital-crown" data-hires- 
status="pending"></span> 
<span>Digital Crown</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/focus-and-selection"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-focus-and-selection" data-hires- 
status="pending"></span> 
<span>Focus and selection</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/game-controllers"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-game-controllers" data-hires- 
status="pending"></span> 
<span>Game controllers</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/gyro-and-accelerometer"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-gyro-and-accelerometer" data-hires- 
status="pending"></span> 


<span>Gyro and accelerometer</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/keyboards"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-keyboards" data-hires- 
status="pending"></span> 
<span>Keyboards</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/pointing-devices"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-pointing-devices" data-hires- 
status="pending"></span> 
<span>Pointing devices</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/remotes"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-remotes" 
data-hires-status="pending"></span> 


<span>Remotes</span> 
</span> 


</a> 


</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/spatial-interactions"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-spatial-interactions" data-hires- 
status="pending"></span> 
<span>Spatial interactions</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/touch-bar"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-touch-bar" data-hires- 
status="pending"></span> 
<span>Touch Bar</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/inputs/touchscreen-gestures"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-touchscreen-gestures" data-hires- 
status="pending"></span> 


<span>Touchscreen gestures</span> 
</span> 
</a> 
</li> 


</ul> 


</li> 


<li class="dn-list-item"> 
class="dn-flex"> 
<span class="dn-icon dn-icon-technologies"></span> 


<span class="dn-list-title">Technologies</span> 


<span 


</span> 


<ul class="dn-list-container" 


style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item dn-list-item-link"> 


<a 


href="/design/human-interface-guidelines/technologies/all-technologies"> 


<span class="dn-flex"> 


<span class="dn-icon dn-icon-all-technologies" data-hires- 
status="pending"></span> 


<span>All technologies</span> 
</span> 


</li> 


<li class="dn-list-item"> 
class="dn-flex"> 


<span class="dn-icon dn-icon-airplay" 
data-hires-status="pending"></span> 


<span class="dn-list-title">AirPlay</span> 


</a> 


<span 


</span> 


<ul class="dn-list-container" 


style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/technologies/airplay/introduction"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-introduction"></span> 
<span>Introduction</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/airplay/icons"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-icons" 
data-hires-status="pending"></span> 
<span>Icons</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/airplay/editorial"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-editorial"></span> 
<span>Editorial</span> 
</span> 
</a> 
</li> 


</ul> 


</li> 


<li class="dn-list-item dn-list-item-link"> 


<a 
href="/design/human-interface-guidelines/technologies/always-on"> 


<span class="dn-flex"> 


<span class="dn-icon dn-icon-always-on" data-hires- 
status="pending"></span> 


<span>Always On</span> 
</span> 


</a> 
</li> 


<li class="dn-list-item"> 
<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-app-clips" 
data-hires-status="pending"></span> 


<span class="dn-list-title">App Clips</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/technologies/app-clips/introduction"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-introduction"></span> 
<span>Introduction</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/app-clips/experience"> 


<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-experience"></span> 


<span>User experience</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/app-clips/app-clip-card"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-app-clip-card"></span> 
<span>App Clip card</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/app-clips/app-clip- 
codes"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-app-clip-codes"></span> 
<span>App Clip Codes</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/app-clips/printing- 
guidelines"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-printing-guidelines"></span> 


<span>Printing guidelines</span> 
</span> 


</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/app-clips/legal- 
requirements"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-legal-requirements"></span> 
<span>Legal requirements</span> 
</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-apple-pay" data-hires- 
status="pending"></span> 
<span class="dn-list-title">Apple Pay</span> 
</span> 


<ul class="dn-list-container" 
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<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/technologies/apple-pay/introduction"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-introduction"></span> 
<span>Introduction</span> 
</span> 
</a> 


</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/apple-pay/offering-apple- 
pay"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-offering-apple-pay"></span> 
<span>Offering Apple Pay</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/apple-pay/checkout-and- 
payment"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-checkout-and-payment"></span> 


<span>Checkout and payment</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/apple-pay/handling- 
errors"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-handling-errors"></span> 
<span>Error handling</span> 
</span> 


</a> 
</li> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/technologies/apple-pay/subscriptions- 
and-donations"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-subscriptions-and-donations"></span> 


<span>Subscriptions and donations</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/apple-pay/buttons-and- 
marks"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-buttons-and-marks"></span> 
<span>Buttons and marks</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/apple-pay/editorial- 
guidelines"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-editorial-guidelines"></span> 
<span>Editorial</span> 
</span> 


</a> 
</li> 


</ul> 


</li> 


<li class="dn-list-item dn-list-item-link"> 


<a 
href="/design/human-interface-guidelines/technologies/augmented-reality"> 


<span class="dn-flex"> 


<span class="dn-icon dn-icon-augmented-reality" data-hires- 
status="pending"></span> 


<span>Augmented reality</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-carekit" 
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<span class="dn-list-title">CareKit</span> 
</span> 
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<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/technologies/carekit/introduction"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-introduction"></span> 
<span>Introduction</span> 
</span> 
</a> 


</li> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/technologies/carekit/data-and- 
privacy"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-data-and-privacy"></span> 
<span>Data and privacy</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/carekit/views"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-views"></span> 
<span>Views</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/carekit/user- 
experience"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-user-experience"></span> 
<span>User experience</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/carekit/symbols-and- 
branding"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-symbols-and-branding"></span> 


<span>Symbols and branding</span> 


</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-carplay" 
data-hires-status="pending"></span> 
<span class="dn-list-title">CarPlay</span> 
</span> 
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<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/technologies/carplay/introduction"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-introduction"></span> 
<span>Introduction</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/carplay/architecture"> 
<span 


class="dn-flex"> 
<span class="dn-icon dn-icon-architecture"></span> 


<span>Architecture</span> 
</span> 


</a> 


</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/carplay/interaction"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-interaction"></span> 
<span>Interaction</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/carplay/visual-design"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-visual-design"></span> 
<span>Visual design</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/carplay/icons-and- 
images"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-icons-and-images"></span> 
<span>Icons and images</span> 
</span> 


</a> 
</li> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/technologies/carplay/system- 
elements"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-system-elements"></span> 
<span>System elements</span> 
</span> 
</a> 
</li> 
</ul> 
</li> 
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<span 
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<span class="dn-list-title">Game Center</span> 
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<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/game-center/ 
introduction"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-introduction"></span> 
<span>Introduction</span> 
</span> 


</a> 
</li> 


«li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/technologies/game-center/access- 
point"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-access-point"></span> 
<span>Access point</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/game-center/ 
dashboard"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-dashboard"></span> 
<span>Dashboard</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/game-center/ 
achievements"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-achievements"></span> 
<span>Achievements</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/game-center/ 
leaderboards"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-leaderboards"></span> 


<span>Leaderboards</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/game-center/ 
multiplayer"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-multiplayer"></span> 
<span>Multiplayer</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/game-center/custom- 
dashboard-links"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-custom-dashboard-links"></span> 
<span>Custom dashboard links</span> 
</span> 
</a> 
</li> 


</ul> 


</li> 


<li class="dn-list-item dn-list-item-link"> 


<a 
href="/design/human-interface-guidelines/technologies/healthkit"> 


<span class="dn-flex"> 


<span class="dn-icon dn-icon-healthkit" 
data-hires-status="pending"></span> 


<span>HealthKit</span> 


</span> 
</a> 
</li> 
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<span class="dn-list-title">HomekKit</span> 
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<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/technologies/homekit/introduction"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-introduction"></span> 
<span>Introduction</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/homekit/terminology- 
and-layout"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-terminology-and-layout"></span> 


<span>Terminology and layout</span> 


</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/homekit/setup"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-setup"></span> 
<span>Setup</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/homekit/siri- 
interactions"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-siri-interactions"></span> 
<span>Siri interactions</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/homekit/custom- 
functionality"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-custom-functionality"></span> 
<span>Custom functionality</span> 
</span> 


</a> 
</li> 


<li class="dn-list-item"> 


<a 
href="/design/human-interface-guidelines/technologies/homekit/icons"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-icons" 
data-hires-status="pending"></span> 
<span>Icons</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/homekit/editorial"> 
<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-editorial"></span> 
<span>Editorial</span> 
</span> 
</a> 
</li> 
</ul> 
</li> 
<li class="dn-list-item dn-list-item-link"> 
<a 
href="/design/human-interface-guidelines/technologies/icloud"> 
<span class="dn-flex"> 
<span class="dn-icon dn-icon-icloud" 
data-hires-status="pending"></span> 
<span>iCloud</span> 
</span> 
</a> 


</li> 


<li class="dn-list-item"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-in-app-purchase" data-hires- 
status="pending"></span> 
<span class="dn-list-title">In-app purchase</span> 
</span> 
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<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/in-app-purchase/ 
introduction"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-introduction"></span> 
<span>Introduction</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/in-app-purchase/auto- 
renewable-subscriptions"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-auto-renewable-subscriptions"></span> 
<span>Auto-renewable subscriptions</span> 
</span> 
</a> 
</li> 


</ul> 


</li> 


<li class="dn-list-item dn-list-item-link"> 


<a 
href="/design/human-interface-guidelines/technologies/live-photos"> 


<span class="dn-flex"> 


<span class="dn-icon dn-icon-live-photos" data-hires- 
status="pending"></span> 


<span>Live Photos</span> 


</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-mac-catalyst" data-hires- 
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<span class="dn-list-title">Mac Catalyst</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/mac-catalyst/ 
introduction"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-introduction"></span> 
<span>Introduction</span> 
</span> 


</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/mac-catalyst/app- 
structure"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-app-structure"></span> 
<span>App structure</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/mac-catalyst/user- 
interaction"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-user-interaction"></span> 
<span>User interaction</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/mac-catalyst/visual- 
design"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-visual-design"></span> 
<span>Visual design</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/mac-catalyst/mac- 
idiom"> 


<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-mac-idiom"></span> 


<span>Mac idiom</span> 
</span> 
</a> 
</li> 


</ul> 


</li> 
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class="dn-flex"> 
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<span class="dn-list-title">Machine learning</span> 
</span> 


<ul class="dn-list-container" 
style="transition: max-height 0.2s ease-in-out 0s;"> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/machine-learning/ 
introduction"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-introduction"></span> 
<span>Introduction</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/machine-learning/roles"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-roles"></span> 


<span>Machine learning roles</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/machine-learning/ 
explicit-feedback"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-explicit-feedback"></span> 
<span>Explicit feedback</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/machine-learning/ 
implicit-feedback"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-implicit-feedback"></span> 
<span>Implicit feedback</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/machine-learning/ 
calibration"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-calibration"></span> 
<span>Calibration</span> 
</span> 


</a> 


</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/machine-learning/ 
corrections"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-corrections"></span> 
<span>Corrections</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/machine-learning/ 
mistakes"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-mistakes"></span> 
<span>Mistakes</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/machine-learning/ 
multiple-options"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-multiple-options"></span> 
<span>Multiple options</span> 
</span> 


</a> 
</li> 


«li class="dn-list-item"> 


<a 


href="/design/human-interface-guidelines/technologies/machine-learning/ 


confidence"> 


class="dn-flex"> 
<span class="dn-icon dn-icon-confidence"></span> 


<span>Confidence</span> 


<li class="dn-list-item"> 


<span 


</span> 
</a> 


<a 


href="/design/human-interface-guidelines/technologies/machine-learning/ 


attribution"> 


class="dn-flex"> 
<span class="dn-icon dn-icon-attribution"></span> 


<span>Attribution</span> 


<li class="dn-list-item"> 


<span 


</span> 
</a> 


<a 


href="/design/human-interface-guidelines/technologies/machine-learning/ 


limitations"> 


class="dn-flex"> 
<span class="dn-icon dn-icon-limitations"></span> 


<span>Limitations</span> 


<span 


</span> 
</a> 


</li> 


<li class="dn-list-item"> 
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class="dn-flex"> 
<span class="dn-icon dn-icon-introduction"></span> 
<span>Introduction</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/maps/apple-watch- 
maps"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-apple-watch-maps"></span> 
<span>Apple Watch maps</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/maps/indoor-maps"> 
<span 


class="dn-flex"> 


<span class="dn-icon dn-icon-indoor-maps"></span> 


<span>Indoor maps</span> 
</span> 
</a> 
</li> 


</ul> 


</li> 


<li class="dn-list-item"> 
<span 
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<span class="dn-list-title">Messages for Business</span> 
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<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-introduction"></span> 
<span>Introduction</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/messages-for-business/ 
branding"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-branding" 
data-hires-status="pending"></span> 


<span>Branding</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/messages-for-business/ 
buttons"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-buttons"></span> 
<span>Buttons</span> 
</span> 
</a> 


</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/messages-for-business/ 
color"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-color" 
data-hires-status="pending"></span> 
<span>Color</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/messages-for-business/ 
dark-mode"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-dark-mode" data-hires- 
status="pending"></span> 
<span>Dark Mode</span> 
</span> 


</a> 


</li> 


<li class="dn-list-item"> 
<a 
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logo"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-logo"></span> 
<span>Logo</span> 
</span> 
</a> 
</li> 
<li class="dn-list-item"> 
<a 


href="/design/human-interface-guidelines/technologies/messages-for-business/ 
message-bubble-content"> 

<span 
class="dn-flex"> 


<span class="dn-icon dn-icon-message-bubble-content"></span> 


<span>Message bubble content</span> 
</span> 
</a> 
</li> 


<li class="dn-list-item"> 
<a 
href="/design/human-interface-guidelines/technologies/messages-for-business/ 
screenshots"> 


<span 
class="dn-flex"> 
<span class="dn-icon dn-icon-screenshots"></span> 
<span>Screenshots</span> 
</span> 


</a> 
</li> 


</ul> 
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<a 
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<span class="dn-flex"> 


<span class="dn-icon dn-icon-nfc" data-hires-status="pending"></span> 


<span>NFC</span> 
</span> 
</a> 
</li> 
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href="/design/human-interface-guidelines/technologies/photo-editing"> 
<span class="dn-flex"> 


<span class="dn-icon dn-icon-photo-editing" data-hires- 
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<span>Photo editing</span> 
</span> 


</a> 
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<a 
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<span class="dn-flex"> 


<span class="dn-icon dn-icon-researchkit" data-hires- 
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<span>ResearchKit</span> 
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class="footer-directory-column-section-link" href="/app-store/small-business- 
program/">App Store Small Business Program</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="https://mfi.apple.com/">MFi 
Program</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/programs/news- 
partner/">News Partner Program</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/programs/video- 
partner/">Video Partner Program</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/security-bounty/">Security 
Bounty Program</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/programs/security-research- 
device/">Security Research Device Program</a></li> 
</ul> 
</div> 


<input class="footer-directory-column-section-state" 
type="checkbox" id="footer-directory-column-section-state-events"> 
<div class="footer-directory-column-section"> 
<label class="footer-directory-column-section-label" 
for="footer-directory-column-section-state-events"> 
<h3 class="footer-directory-column-section- 
title">Events</h3> 
</label> 
<a href="#footer-directory-column-section-state-events" 
class="footer-directory-column-section-anchor footer-directory-column-section- 
anchor-open"> <span class="footer-directory-column-section-anchor- 
label">Open Menu</span> </a> 
<a href="#" class="footer-directory-column-section-anchor 
footer-directory-column-section-anchor-close"> <span class="footer-directory- 
column-section-anchor-label">Close Menu</span> </a> 
<ul class="footer-directory-column-section-list"> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/accelerator/">App 
Accelerators</a></li> 
«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/app-store/app-store- 
awards/">App Store Awards</a></li> 


«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/design/awards/">Apple 
Design Awards</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" 
href="/learn/experts/#academies">Apple Developer Academies</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/entrepreneur- 
camp/">Entrepreneur Camp</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/tech-talks/">Tech 
Talks</a></li> 

«li class="footer-directory-column-section-item"><a 
class="footer-directory-column-section-link" href="/wwdc/">WWDC</a></li> 


</ul> 
</div> 
</div> 
<!--googleon: all--> 
</nav> 


<section class="footer-mini" vocab="http://schema.org/" 
typeof="Organization"> 
<div class="footer-mini-news"> 
<div class="copy"> 
To view the latest developer news, visit <a 
href="/news/">News and Updates</a>. 
</div> 
<div class="content"> 
<div class="color-scheme-toggle" role="radiogroup" 
tabindex="0" aria-label="Select a color scheme preference"> 


<label data-color-scheme-option="light"> 
<input type="radio" value="light" 
autocomplete="off" 
onchange="window.setPreferredColorScheme(event.target.value)"> 
<div class="text">Light</div> 
</label> 
<label data-color-scheme-option="dark"> 
<input type="radio" value="dark" 
autocomplete="off" 
onchange="window.setPreferredColorScheme(event.target.value)"> 
<div class="text">Dark</div> 


</label> 


<label data-color-scheme-option="auto"> 


<input type="radio" value="auto" 
autocomplete="off" 
onchange="window.setPreferredColorScheme(event.target.value)"> 


<div class="text">Auto</div> 
</label> 


</div> 
<script async="" src="/assets/scripts/color-scheme- 
toggle.js"></script> 
</div> 
</div> 
<link rel="stylesheet" href="/assets/styles/language-dropdown.css? 
41172203193"> 
<div class="language-dropdown dropdown-container hidden"> 
<select class="dropdown" aria-label="Language 
Dropdown"></select> 
<span class="dropdown-icon icon icon-chevrondown" aria- 
hidden="true"></span> 
</div> 
<script async="" src="/assets/scripts/lib/jquery/jquery.language- 
dropdown.js?41172203193"></script> 
<div class="footer-mini-legal"> 
<div class="footer-mini-legal-copyright">Copyright © 2022 <a 
href="https://www.apple.com">Apple Inc.</a> All rights reserved.</div> 
<div class="footer-mini-legal-links"> 
<a class="footer-mini-legal-link" 
href="https://www.apple.com/legal/internet-services/terms/site.html">Terms of 
Use</a> 
<a class="footer-mini-legal-link" 
href="https://www.apple.com/legal/privacy/en-ww/">Privacy Policy</a> 
<a class="footer-mini-legal-link" 
href="/support/terms/">Agreements and Guidelines</a> 
</div> 
</div> 
</section> 
</div> 
</footer> 


</body></html> 


